SerialPort.ReadTo(String) Methode

Definition

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Quelle:

SerialPort.cs

Liest eine Zeichenfolge bis zum angegebenen value im Eingabepuffer.

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

Parameter

value

String

Ein Wert, der angibt, wo der Lesevorgang anhält.

Gibt zurück

String

Der Inhalt des Eingabepuffers bis zum angegebenen value.

Ausnahmen

ArgumentException

Die Länge des value-Parameters ist 0 (null).

ArgumentNullException

Der value-Parameter ist null.

InvalidOperationException

Der angegebene Anschluss ist nicht offen.

TimeoutException

Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.

Hinweise

Diese Methode liest eine Zeichenfolge bis zum angegebenen value. Während die zurückgegebene Zeichenfolge nicht enthält value, wird der value aus dem Eingabepuffer entfernt.

Wenn zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Stream gewechselt werden muss, wählen Sie ein Protokoll aus, das die Grenze zwischen Text- und Binärdaten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodieren der Daten.

Hinweis

Da die SerialPort Klasse Daten puffert und der in der BaseStream -Eigenschaft enthaltene Stream nicht, können die beiden in Konflikt geraten, wie viele Bytes zum Lesen verfügbar sind. Die BytesToRead -Eigenschaft kann angeben, dass Bytes zu lesen sind, aber diese Bytes sind für den in der BaseStream -Eigenschaft enthaltenen Stream möglicherweise nicht zugänglich, da sie für die SerialPort Klasse gepuffert wurden.