SerialPort.ReadTo(String) Methode

Definition

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

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

Der value-Parameter ist null.

Der angegebene Anschluss ist nicht offen.

Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.

Hinweise

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

Wenn es notwendig ist, zwischen Lesetext und Lese binärdaten aus dem Datenstrom zu wechseln, wählen Sie ein Protokoll aus, das die Grenze zwischen Text und Binärdaten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodierung der Daten.

Hinweis

Da die SerialPort Klassenpuffer daten und der Datenstrom, der in der BaseStream Eigenschaft enthalten ist, nicht enthalten ist, kann die beiden konflikten, wie viele Bytes zum Lesen verfügbar sind. Die BytesToRead Eigenschaft kann darauf hinweisen, dass Bytes gelesen werden, aber diese Bytes können möglicherweise nicht auf den datenstrom zugreifen, der in der BaseStream Eigenschaft enthalten ist, da sie an die SerialPort Klasse gepuffert wurden.

Gilt für