SerialPort.Write メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
シリアル ポート出力バッファーにデータを書き込みます。
オーバーロード
| 名前 | 説明 |
|---|---|
| Write(String) |
指定した文字列をシリアル ポートに書き込みます。 |
| Write(Byte[], Int32, Int32) |
バッファーからのデータを使用して、指定したバイト数をシリアル ポートに書き込みます。 |
| Write(Char[], Int32, Int32) |
バッファーからのデータを使用して、指定した数の文字をシリアル ポートに書き込みます。 |
Write(String)
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
指定した文字列をシリアル ポートに書き込みます。
public:
void Write(System::String ^ text);public void Write(string text);member this.Write : string -> unitPublic Sub Write (text As String)パラメーター
- text
- String
出力の文字列。
例外
指定されたポートが開いていません。
text は nullです。
タイムアウト期間が終了する前に操作が完了しませんでした。
注釈
シリアル ポートに出力として文字列を書き込む場合は、このメソッドを使用します。
出力バッファーにバイトが多すぎて、 Handshake が XOnXOff に設定されている場合、 SerialPort オブジェクトは、デバイスがより多くのデータを受け入れる準備が整うのを待つ間に TimeoutException を発生させる可能性があります。
既定では、 SerialPort は ASCIIEncoding を使用して文字をエンコードします。 ASCIIEncoding は、127 より大きいすべての文字を (char)63 または '?' としてエンコードします。 その範囲内の追加の文字をサポートするには、 Encoding を UTF8Encoding、 UTF32Encoding、または UnicodeEncodingに設定します。
適用対象
Write(Byte[], Int32, Int32)
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
- ソース:
- 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 -> unitPublic Sub Write (buffer As Byte(), offset As Integer, count As Integer)パラメーター
- buffer
- Byte[]
ポートに書き込むデータを格納するバイト配列。
- offset
- Int32
ポートへのバイトのコピーを開始する buffer パラメーター内の 0 から始まるバイト オフセット。
- count
- Int32
書き込むバイト数。
例外
渡された buffer は null。
指定されたポートが開いていません。
offsetまたはcountパラメーターは、渡されるbufferの有効な領域の外部にあります。
offsetまたはcountが 0 未満です。
offset プラス count が bufferの長さを超えています。
タイムアウト期間が終了する前に操作が完了しませんでした。
注釈
シリアル ポートへの出力を作成するためにバイト バッファーに書き込む場合は、このメソッドを使用します。
出力バッファーにバイトが多すぎて、 Handshake が XOnXOff に設定されている場合、 SerialPort オブジェクトは、デバイスがより多くのデータを受け入れる準備が整うのを待つ間に TimeoutException を発生させる可能性があります。
適用対象
Write(Char[], Int32, Int32)
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
- ソース:
- SerialPort.cs
- ソース:
- 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 -> unitPublic Sub Write (buffer As Char(), offset As Integer, count As Integer)パラメーター
- buffer
- Char[]
ポートに書き込むデータを含む文字配列。
- offset
- Int32
ポートへのバイトのコピーを開始する buffer パラメーター内の 0 から始まるバイト オフセット。
- count
- Int32
書き込む文字数。
例外
渡された buffer は null。
指定されたポートが開いていません。
offsetまたはcountパラメーターは、渡されるbufferの有効な領域の外部にあります。
offsetまたはcountが 0 未満です。
offset プラス count が bufferの長さを超えています。
タイムアウト期間が終了する前に操作が完了しませんでした。
注釈
シリアル ポートへの出力を作成するために文字バッファーに書き込む場合は、このメソッドを使用します。
出力バッファーにバイトが多すぎて、 Handshake が XOnXOff に設定されている場合、 SerialPort オブジェクトは、デバイスがより多くのデータを受け入れる準備が整うのを待つ間に TimeoutException を発生させる可能性があります。
既定では、 SerialPort は ASCIIEncoding を使用して文字をエンコードします。 ASCIIEncoding は、127 より大きいすべての文字を (char)63 または '?' としてエンコードします。 その範囲内の追加の文字をサポートするには、 Encoding を UTF8Encoding、 UTF32Encoding、または UnicodeEncodingに設定します。
