SerialPort.Write 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將資料寫入序列埠輸出緩衝區。
多載
| 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 -> 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)
使用緩衝區中的資料，將指定的位元組數目寫入序列埠。
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 參數中以零為起始的位元組位移，將會從該處開始將位元組複製到連接埠。
- count
- Int32
要寫入的位元組數。
例外狀況
傳遞的 buffer 為 null。
指定的連接埠未開啟。
offset 或 count 參數超出所傳遞之 buffer 的有效區域以外。 offset 或 count 小於零。
offset 加上 count 大於 buffer 的長度。
作業沒有在逾時期間結束之前完成。
備註
當您想要寫入位元組緩衝區以建立串行埠的輸出時，請使用這個方法。
如果輸出緩衝區中有太多位元組，而且 Handshake 設定為 XOnXOff ，則 SerialPort 物件可能會在等候裝置準備好接受更多資料時引發 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 -> unitPublic Sub Write (buffer As Char(), offset As Integer, count As Integer)參數
- buffer
- Char[]
包含要寫入連接埠之資料的字元陣列。
- offset
- Int32
buffer 參數中以零為起始的位元組位移，將會從該處開始將位元組複製到連接埠。
- count
- Int32
要寫入的字元數。
例外狀況
傳遞的 buffer 為 null。
指定的連接埠未開啟。
offset 或 count 參數超出所傳遞之 buffer 的有效區域以外。 offset 或 count 小於零。
offset 加上 count 大於 buffer 的長度。
作業沒有在逾時期間結束之前完成。
備註
當您要寫入字元緩衝區以建立串行埠的輸出時，請使用這個方法。
如果輸出緩衝區中有太多位元組，而且 Handshake 設定為 XOnXOff ，則 SerialPort 物件可能會在等候裝置準備好接受更多資料時引發 TimeoutException 。
根據預設， SerialPort 會使用 ASCIIEncoding 來編碼字元。 ASCIIEncoding 將所有大於 127 的字元編碼為 (char) 63 或 '？'。 若要支援這個範圍中的其他字元，請將 設定 Encoding 為 UTF8Encoding、 UTF32Encoding或 UnicodeEncoding。
