SerialPort.ReadChar 方法

定義

命名空間:

System.IO.Ports

組件:

System.IO.Ports.dll

組件:

System.dll

從 SerialPort 輸入緩衝區同步讀取一個字元。

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

傳回

Int32

讀取的字元。

例外狀況

InvalidOperationException

指定的連接埠未開啟。

TimeoutException

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

-或-

指定逾時期間沒有可用的字元。

備註

此方法會根據編碼方式讀取一個完整字元。

同時使用 和 ReadChar 時 ReadByte ，請小心。 在讀取位元組和讀取字元之間切換可能會導致讀取額外資料，以及/或其他非預期的行為。 如果需要在讀取文字和從資料流程讀取二進位資料之間切換，請選取一個通訊協定，以仔細定義文字和二進位資料之間的界限，例如手動讀取位元組和解碼資料。

注意

因為類別 SerialPort 會緩衝資料，而且 屬性中包含的 BaseStream 資料流程沒有，所以這兩者可能會與可供讀取的位元組數目衝突。 屬性 BytesToRead 可以指出有位元組可讀取，但這些位元組可能無法供 屬性中包含的 BaseStream 資料流程存取，因為它們已緩衝處理至 SerialPort 類別。