SerialPort.ReadTo(String) Metoda

Definice

Obor názvů:

System.IO.Ports

Sestavení:

System.IO.Ports.dll

Balíček:

System.IO.Ports v8.0.0

Zdroj:

SerialPort.cs

Načte řetězec až do zadaného value ve vstupní vyrovnávací paměti.

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

Parametry

value

String

Hodnota, která určuje, kde se operace čtení zastaví.

Návraty

String

Obsah vstupní vyrovnávací paměti až do zadané valuehodnoty .

Výjimky

ArgumentException

Délka parametru value je 0.

ArgumentNullException

Parametr value je null.

InvalidOperationException

Zadaný port není otevřený.

TimeoutException

Operace se nedokončila před vypršením časového limitu.

Poznámky

Tato metoda načte řetězec až do zadaného value. I když vrácený řetězec neobsahuje value, odebere value se ze vstupní vyrovnávací paměti.

Pokud je nutné přepínat mezi čtením textu a čtením binárních dat ze streamu, vyberte protokol, který pečlivě definuje hranici mezi textovými a binárními daty, například ruční čtení bajtů a dekódování dat.

Poznámka

Vzhledem k tomu, že SerialPort třída data do vyrovnávací paměti a datový proud obsažený ve BaseStream vlastnosti ne, můžou tyto dvě třídy kolidovat o tom, kolik bajtů je k dispozici ke čtení. Vlastnost BytesToRead může znamenat, že existují bajty ke čtení, ale tyto bajty nemusí být přístupné pro datový proud obsažený ve BaseStream vlastnosti, protože byly převedeny do vyrovnávací paměti třídy SerialPort .