SerialPort.ReadChar 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 znak z buforu wejściowego SerialPort .

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

Zwraca

Int32

Znak, który został odczytany.

Wyjątki

InvalidOperationException

Podany port nie jest otwarty.

TimeoutException

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

-lub-

Żaden znak nie był dostępny w wyznaczonym przedziale czasu.

Uwagi

Ta metoda odczytuje jeden pełny znak na podstawie kodowania.

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.