SerialPort.ReadByte 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 bajt ze SerialPort vstupní vyrovnávací paměti.

public:
 int ReadByte();

public int ReadByte ();

member this.ReadByte : unit -> int

Public Function ReadByte () As Integer

Návraty

Int32

Bajt, přetypování na Int32, nebo -1, pokud byl přečtený konec datového proudu.

Výjimky

InvalidOperationException

Zadaný port není otevřený.

TimeoutException

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

-nebo-

Nebyl přečtený žádný bajt.

Poznámky

Tato metoda čte jeden bajt.

Při společném používání ReadByte a ReadChar buďte opatrní. Přepínání mezi přečtenými bajty a znaky čtení může způsobit čtení dalších dat nebo jiné nezamýšlené chování. 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 .