SerialPort.ReadChar Metoda

Definice

Obor názvů:

System.IO.Ports

Sestavení:

System.IO.Ports.dll

Balíček:

System.IO.Ports v8.0.0

Zdroj:

SerialPort.cs

Synchronně čte jeden znak ze SerialPort vstupní vyrovnávací paměti.

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

Návraty

Int32

Znak, který byl přečtený.

Výjimky

InvalidOperationException

Zadaný port není otevřený.

TimeoutException

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

-nebo-

V přiděleném časovém limitu nebyl k dispozici žádný znak.

Poznámky

Tato metoda přečte jeden úplný znak na základě kódování.

Při používání ReadByte a ReadChar společně buďte opatrní. Přepínání mezi čtením bajtů a čtení znaků může způsobit čtení dalších dat nebo jiné neúmyslné chování. Pokud je potřeba 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 ukládání dat 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 do vyrovnávací paměti třídy SerialPort .