SerialPort.Write 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將資料寫入序列埠輸出緩衝區。
多載
| 名稱 | Description |
|---|---|
| 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有效區域之外。 或 offsetcount 或 都小於零。
offset plus 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有效區域之外。 或 offsetcount 或 都小於零。
offset plus count 大於 的 buffer長度。
該行動未能在暫停期結束前完成。
備註
當你想寫入字元緩衝區以產生輸出到序列埠時，可以使用這個方法。
如果輸出緩衝區中位元組過多且 Handshake 設定為 ， XOnXOff 物件 SerialPort 可能會在等待裝置準備好接受更多資料期間，暫時升起 TimeoutException 資料。
預設情況下， SerialPort 會用 ASCIIEncoding 來編碼字元。 ASCIIEncoding 將所有大於 127 的字元編碼為 （char）63 或 '？'。 若要支援該範圍內的其他字元，請設 Encoding 為 UTF8Encoding、 UTF32Encoding、 或 UnicodeEncoding。
