SerialPort.ReadByte 方法

定義

命名空間:

System.IO.Ports

組件:

System.IO.Ports.dll

套件:

System.IO.Ports v8.0.0

來源:

SerialPort.cs

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

public:
 int ReadByte();

public int ReadByte ();

member this.ReadByte : unit -> int

Public Function ReadByte () As Integer

傳回

Int32

轉換為 Int32 的位元組，如果已讀取資料流的末端，則為 -1。

例外狀況

InvalidOperationException

指定的連接埠未開啟。

TimeoutException

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

-或-

沒有讀取任何位元組。

備註

這個方法會讀取一個字節。

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

注意

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