SerialPort.ReadExisting 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 všechny okamžitě dostupné bajty na základě kódování v datovém proudu i vstupní vyrovnávací paměti objektu SerialPort .

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Návraty

String

Obsah datového proudu a vstupní vyrovnávací paměť objektu SerialPort .

Výjimky

InvalidOperationException

Zadaný port není otevřený.

Poznámky

Tato metoda vrátí obsah datového proudu a vnitřní vyrovnávací paměti objektu SerialPort jako řetězec. Tato metoda nepoužívá časový limit. Všimněte si, že tato metoda může ponechat koncové počáteční bajty v interní vyrovnávací paměti, takže hodnota je BytesToRead větší než nula.

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

Třída SerialPort data do vyrovnávací paměti, ale objekt streamu obsažený ve SerialPort.BaseStream vlastnosti nikoli. Proto se SerialPort objekt a objekt streamu mohou lišit podle počtu bajtů, které jsou k dispozici ke čtení. Při ukládání bajtů do vyrovnávací paměti objektu SerialPortBytesToRead zahrnuje vlastnost tyto bajty ve své hodnotě; tyto bajty však nemusí být přístupné pro datový proud obsažený ve BaseStream vlastnosti.