5.1. StarNetworkManager

プリンタのネットワーク設定を行うためのクラスです。

コンストラクタ

名称

説明

StarNetworkManager

インスタンスを生成します。

メソッド

名称

説明

LoadAsync

接続したプリンタから設定を取得します。

ApplyAsync

プリンタに指定した値を設定します。

各モデルにおいて機能するメソッドは以下のとおりです。

モデル/エミュレーション	mC-Print2	mC-Print3	mC-Label3
モデル/エミュレーション	StarPRNT	StarPRNT	StarPRNT
LoadAsync	✔	✔	✔
ApplyAsync	✔	✔	✔

5.1.1. StarNetworkManager

インスタンスを生成します。

宣言

public StarNetworkManager(string portName)

引数

引数

説明

型

portName

ConnectAsync メソッドのportNameと同じです。

string
戻り値

説明

型

StarNetworkManager オブジェクト

StarNetworkManager

例外

説明

型

portNameにnullを設定したとき

StarIODeviceSettingException

5.1.2. LoadAsync

接続したプリンタから設定を取得します。

宣言

public IAsyncOperation<StarNetworkSetting> LoadAsync()

引数

なし
戻り値

説明

型

ネットワーク設定内容

StarNetworkSetting
例外

説明

型

ポートオープンに失敗したとき

誤ったportNameを設定したとき

通信エラーが発生したとき

StarIODeviceSettingException

実装例

private async void LoadButton_Click(object sender, RoutedEventArgs e)
{
    StarNetworkManager starNetworkManager = new StarNetworkManager(PortName.Text);
    StarNetworkSetting starNetworkSetting = new StarNetworkSetting();

    try
    {
        starNetworkSetting = await starNetworkManager.LoadAsync();
    }
    catch (StarIODeviceSettingException ex)
    {
    }
}

StarIODeviceSettingSDKを参照ください。

5.1.3. ApplyAsync

プリンタに指定した値を設定します。

重要

本メソッド実行後、プリンターのリセットがかかります。

宣言

public IAsyncAction ApplyAsync(StarNetworkSetting setting)

引数

名称

説明

型

setting

ネットワーク設定情報

StarNetworkSetting
戻り値

なし
例外

説明

型

ポートオープンに失敗したとき

誤ったportNameを設定したとき

通信エラーが発生したとき

StarIODeviceSettingException

実装例

private async void ApplyButton_Click(object sender, RoutedEventArgs e)
{
    StarNetworkManager starNetworkManager = new StarNetworkManager(PortName.Text);
    StarNetworkSetting starNetworkSetting = new StarNetworkSetting();

    //Example) When setting to SteadyLanSetting to "Disable"
    starNetworkSetting.SteadyLan = SteadyLanSetting.Disable;

    try
    {
        await starNetworkManager.ApplyAsync(starNetworkSetting);
    }
    catch (StarIODeviceSettingException ex)
    {
    }
}

StarIODeviceSettingSDKを参照ください。