Sdílet prostřednictvím


SerialPort.ReadByte Metoda

Definice

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

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

Výjimky

Zadaný port není otevřený.

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 použití ReadByte a ReadChar společně buďte opatrní. Přepínání mezi bajty čtení a čtením znaků může způsobit čtení nadbytečný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 ukládají data do vyrovnávací paměti a datový proud obsažený ve BaseStream vlastnosti ne, mohou tyto dva konflikty o tom, kolik bajtů je možné číst. 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 .

Platí pro