SerialPort.ReadByte Metoda

Definicja

Przestrzeń nazw:

System.IO.Ports

Zestaw:

System.IO.Ports.dll

Pakiet:

System.IO.Ports v8.0.0

Źródło:

SerialPort.cs

Synchronicznie odczytuje jeden bajt z buforu wejściowego SerialPort .

public:
 int ReadByte();

public int ReadByte ();

member this.ReadByte : unit -> int

Public Function ReadByte () As Integer

Zwraca

Int32

Bajt, rzutowany na Int32, lub -1, jeśli koniec strumienia został odczytany.

Wyjątki

InvalidOperationException

Podany port nie jest otwarty.

TimeoutException

Operacja nie została ukończona przed upłynięciem limitu czasu.

-lub-

Nie odczytano bajtu.

Uwagi

Ta metoda odczytuje jeden bajt.

Należy zachować ostrożność podczas używania ReadByte i ReadChar łączenia. Przełączanie się między odczytywaniem bajtów a znakami odczytu może spowodować, że odczyt dodatkowych danych i/lub inne niezamierzone zachowanie. Jeśli zachodzi potrzeba przełączenia się między czytaniem tekstu i czytanie ze strumienia danych binarnych, należy wybrać protokół, który dokładnie definiuje granicę między tekstem i danymi binarnymi, taki jak ręczne odczytywanie bajtów i dekodowanie danych.

Uwaga

SerialPort Ponieważ klasa buforuje dane, a strumień zawarty we BaseStream właściwości nie, te dwa mogą powodować konflikt co do liczby dostępnych bajtów do odczytu. Właściwość BytesToRead może wskazywać, że istnieją bajty do odczytania, ale te bajty mogą nie być dostępne dla strumienia zawartego BaseStream we właściwości, ponieważ zostały one buforowane do SerialPort klasy.