SerialPort.Write メソッド

定義

名前空間:

System.IO.Ports

アセンブリ:

System.IO.Ports.dll

パッケージ:

System.IO.Ports v8.0.0

シリアル ポートの出力バッファーにデータを書き込みます。

オーバーロード

Write(String)	指定した文字列をシリアル ポートに書き込みます。
Write(Byte[], Int32, Int32)	バッファーのデータを使用して、指定したバイト数をシリアル ポートに書き込みます。
Write(Char[], Int32, Int32)	バッファーのデータを使用して、指定した文字数をシリアル ポートに書き込みます。

Write(String)

ソース:

SerialPort.cs

指定した文字列をシリアル ポートに書き込みます。

public:
 void Write(System::String ^ text);

public void Write (string text);

member this.Write : string -> unit

Public Sub Write (text As String)

パラメーター

text

String

出力用の文字列。

例外

InvalidOperationException

指定したポートが開いていません。

ArgumentNullException

text が nullです。

TimeoutException

タイムアウト時間内に操作が完了しませんでした。

注釈

シリアル ポートに出力として文字列を書き込む場合は、このメソッドを使用します。

出力バッファーHandshakeにバイト数が多すぎて にXOnXOffSerialPort設定されている場合、オブジェクトは、デバイスがより多くのデータを受け入れる準備が整うのを待機している間に を発生TimeoutExceptionさせる可能性があります。

既定では、 SerialPort を使用 ASCIIEncoding して文字をエンコードします。 ASCIIEncoding は、127 より大きいすべての文字を (char)63 または '?' としてエンコードします。 その範囲内の追加の文字をサポートするには、または UnicodeEncodingにUTF32EncodingUTF8Encoding設定Encodingします。

Write(Byte[], Int32, Int32)

ソース:

SerialPort.cs

バッファーのデータを使用して、指定したバイト数をシリアル ポートに書き込みます。

public:
 void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public void Write (byte[] buffer, int offset, int count);

member this.Write : byte[] * int * int -> unit

Public Sub Write (buffer As Byte(), offset As Integer, count As Integer)

パラメーター

buffer

Byte[]

ポートに書き込むデータを格納したバイト配列。

offset

Int32

ポートへのバイトのコピーを開始する位置を示す buffer パラメーター内のバイト オフセット。インデックス番号は 0 から始まります。

count

Int32

書き込むバイト数。

例外

ArgumentNullException

渡された buffer が null です。

InvalidOperationException

指定したポートが開いていません。

ArgumentOutOfRangeException

offset パラメーターまたは count パラメーターが、渡される buffer の有効な領域外です。 offset または count のいずれかが 0 より小さい値です。

ArgumentException

offset に count を加算した値が、buffer の長さを超えています。

TimeoutException

タイムアウト時間内に操作が完了しませんでした。

注釈

シリアル ポートへの出力を作成するためにバイト バッファーに書き込む場合は、このメソッドを使用します。

出力バッファーHandshakeにバイト数が多すぎて にXOnXOffSerialPort設定されている場合、オブジェクトは、デバイスがより多くのデータを受け入れる準備が整うのを待機している間に を発生TimeoutExceptionさせる可能性があります。

Write(Char[], Int32, Int32)

ソース:

SerialPort.cs

バッファーのデータを使用して、指定した文字数をシリアル ポートに書き込みます。

public:
 void Write(cli::array <char> ^ buffer, int offset, int count);

public void Write (char[] buffer, int offset, int count);

member this.Write : char[] * int * int -> unit

Public Sub Write (buffer As Char(), offset As Integer, count As Integer)

パラメーター

buffer

Char[]

ポートに書き込むデータを格納した文字配列。

offset

Int32

ポートへのバイトのコピーを開始する位置を示す buffer パラメーター内のバイト オフセット。インデックス番号は 0 から始まります。

count

Int32

書き込む文字数。

例外

ArgumentNullException

渡された buffer が null です。

InvalidOperationException

指定したポートが開いていません。

ArgumentOutOfRangeException

offset パラメーターまたは count パラメーターが、渡される buffer の有効な領域外です。 offset または count のいずれかが 0 より小さい値です。

ArgumentException

offset に count を加算した値が、buffer の長さを超えています。

TimeoutException

タイムアウト時間内に操作が完了しませんでした。

注釈

シリアル ポートへの出力を作成する文字バッファーに書き込む場合は、このメソッドを使用します。

出力バッファーHandshakeにバイト数が多すぎて にXOnXOffSerialPort設定されている場合、オブジェクトは、デバイスがより多くのデータを受け入れる準備が整うのを待機している間に を発生TimeoutExceptionさせる可能性があります。

既定では、 SerialPort を使用 ASCIIEncoding して文字をエンコードします。 ASCIIEncoding は、127 より大きいすべての文字を (char)63 または '?' としてエンコードします。 その範囲内の追加の文字をサポートするには、または UnicodeEncodingにUTF32EncodingUTF8Encoding設定Encodingします。