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 設定為 XOnXOff ，則 SerialPort 物件可能會在等候裝置準備好接受更多資料時引發 TimeoutException 。

根據預設， SerialPort 會使用 ASCIIEncoding 來編碼字元。 ASCIIEncoding 將所有大於 127 的字元編碼為 (char) 63 或 '？'。 若要支援該範圍中的其他字元，請將 設定 Encoding 為 UTF8Encoding 、 UTF32Encoding 或 UnicodeEncoding 。

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 參數中以零為起始的位元組位移，將會從該處開始將位元組複製到連接埠。

count

Int32

要寫入的位元組數。

例外狀況

ArgumentNullException

傳遞的 buffer 為 null。

InvalidOperationException

指定的連接埠未開啟。

ArgumentOutOfRangeException

offset 或 count 參數超出所傳遞之 buffer 的有效區域以外。 offset 或 count 小於零。

ArgumentException

offset 加上 count 大於 buffer 的長度。

TimeoutException

作業沒有在逾時期間結束之前完成。

備註

當您想要寫入位元組緩衝區以建立序列埠的輸出時，請使用這個方法。

如果輸出緩衝區中有太多位元組，而且 Handshake 設定為 XOnXOff ，則 SerialPort 物件可能會在等候裝置準備好接受更多資料時引發 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 參數中以零為起始的位元組位移，將會從該處開始將位元組複製到連接埠。

count

Int32

要寫入的字元數。

例外狀況

ArgumentNullException

傳遞的 buffer 為 null。

InvalidOperationException

指定的連接埠未開啟。

ArgumentOutOfRangeException

offset 或 count 參數超出所傳遞之 buffer 的有效區域以外。 offset 或 count 小於零。

ArgumentException

offset 加上 count 大於 buffer 的長度。

TimeoutException

作業沒有在逾時期間結束之前完成。

備註

當您想要寫入字元緩衝區以建立序列埠的輸出時，請使用這個方法。

如果輸出緩衝區中有太多位元組，而且 Handshake 設定為 XOnXOff ，則 SerialPort 物件可能會在等候裝置準備好接受更多資料時引發 TimeoutException 。

根據預設， SerialPort 會使用 ASCIIEncoding 來編碼字元。 ASCIIEncoding 將所有大於 127 的字元編碼為 (char) 63 或 '？'。 若要支援該範圍中的其他字元，請將 設定 Encoding 為 UTF8Encoding 、 UTF32Encoding 或 UnicodeEncoding 。