English site 日本語サイト

5.1. StarNetworkManager

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

• コンストラクタ

  名称	説明
  StarNetworkManager	インスタンスを生成します。

• メソッド

  名称	説明
  Load	接続したプリンタから設定を取得します。
  Apply	プリンタに指定した値を設定します。

各モデルにおいて機能するメソッドは以下のとおりです。

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

5.1.1. StarNetworkManager

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

• 宣言

  public StarNetworkManager(string portName)
  

• 引数

  引数	説明	型
  portName	GetPort メソッドのportNameと同じです。	string

• 戻り値

  説明	型
  StarNetworkManager オブジェクト	StarNetworkManager

• 例外

  説明	型
  portNameにnullを設定したとき	StarIODeviceSettingException

5.1.2. Load

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

• 宣言

  public StarNetworkSetting Load()
  

• 引数

  なし

• 戻り値

  説明	型
  ネットワーク設定内容	StarNetworkSetting

• 例外

  説明	型
  ポートオープンに失敗したとき 誤ったportNameを設定したとき 通信エラーが発生したとき	StarIODeviceSettingException

• 実装例

  private void LoadButton_Click(object sender, RoutedEventArgs e)
  {
      string portName = PortNameTextBox.Text;
      StarNetworkManager manager = new StarNetworkManager(portName);
  
      try
      {
          StarNetworkSetting setting = manager.Load();
          SteadyLanSetting steadyLan = setting.SteadyLan;
      }
      catch (StarIODeviceSettingException ex)
      {
      }
  }
  

  StarIODeviceSettingSDKを参照ください。

5.1.3. Apply

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

重要

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

• 宣言

  public void Apply(StarNetworkSetting setting)
  

• 引数

  名称	説明	型
  setting	ネットワーク設定情報	StarNetworkSetting

• 戻り値

  なし

• 例外

  説明	型
  ポートオープンに失敗したとき 誤ったportNameを設定したとき 通信エラーが発生したとき	StarIODeviceSettingException

• 実装例

  private void ApplyButton_Click(object sender, RoutedEventArgs e)
  {
      string portName = PortNameTextBox.Text;
      StarNetworkManager manager = new StarNetworkManager(portName);
  
      //Example) When setting to SteadyLanSetting to "Disable"
      SteadyLanSetting steadyLan = SteadyLanSetting.Disable;
  
      StarNetworkSetting setting = new StarNetworkSetting()
      {
          SteadyLan = steadyLan
      };
  
      try
      {
          manager.Apply(setting);
      }
      catch (StarIODeviceSettingException ex)
      {
      }
  }
  

  StarIODeviceSettingSDKを参照ください。