SerialPort.ReadTo(String) 方法

定義

命名空間:

System.IO.Ports

組件:

System.IO.Ports.dll

套件:

System.IO.Ports v8.0.0

來源:

SerialPort.cs

讀取在輸入緩衝區中指定 value 之前的字串。

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

參數

value

String

指出讀取作業停止位置的值。

傳回

String

指定 value 之前的輸入緩衝區內容。

例外狀況

ArgumentException

value 參數的長度為 0。

ArgumentNullException

value 參數為 null。

InvalidOperationException

指定的連接埠未開啟。

TimeoutException

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

備註

這個方法會讀取字串到指定的 value。 雖然傳回的字串不包含 value，但 value 會從輸入緩衝區中移除 。

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

注意

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