SerialPort.Write メソッド

定義

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

オーバーロード

Write(String)

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

Write(Byte[], Int32, Int32)

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

Write(Char[], Int32, Int32)

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

Write(String)

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

public:
 void Write(System::String ^ text);
public void Write (string text);
member this.Write : string -> unit
Public Sub Write (text As String)

パラメーター

text
String

出力用の文字列。

例外

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

textnullです。

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

注釈

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

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

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

適用対象

Write(Byte[], Int32, Int32)

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

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

書き込むバイト数。

例外

渡された buffernull です。

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

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

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

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

注釈

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

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

適用対象

Write(Char[], Int32, Int32)

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

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

書き込む文字数。

例外

渡された buffernull です。

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

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

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

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

注釈

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

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

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

適用対象