SerialPort.ReadExisting 方法

定義

命名空間:

System.IO.Ports

組件:

System.IO.Ports.dll

套件:

System.IO.Ports v8.0.0

來源:

SerialPort.cs

根據編碼方式，讀取 SerialPort 物件的資料流和輸入緩衝區中所有立即可用的位元組。

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

傳回

String

SerialPort 物件的資料流和輸入緩衝區的內容。

例外狀況

InvalidOperationException

指定的連接埠未開啟。

備註

這個方法會以字串的形式傳回 物件之數據流和內部緩衝區 SerialPort 的內容。 這個方法不會使用逾時。請注意，這個方法可以在內部緩衝區中保留尾端前置位元組，使 BytesToRead 值大於零。

如果需要在讀取文字和從數據流讀取二進位數據之間切換，請選取仔細定義文字與二進位數據之間的界限的通訊協定，例如手動讀取位元組和譯碼數據。

注意

類別 SerialPort 會緩衝處理數據，但屬性中包含的 SerialPort.BaseStream 數據流物件則不會。 因此， SerialPort 對象和數據流物件可能會與可供讀取的位元元組數目不同。 當位元組緩衝處理至 SerialPort 物件時， BytesToRead 屬性會在其值中包含這些位元組;不過，屬性中包含的 BaseStream 數據流可能無法存取這些位元組。