SerialPort.ReadExisting Metoda

Definicja

Przestrzeń nazw:

System.IO.Ports

Zestaw:

System.IO.Ports.dll

Pakiet:

System.IO.Ports v8.0.0

Źródło:

SerialPort.cs

Odczytuje wszystkie natychmiast dostępne bajty na podstawie kodowania zarówno w strumieniu, jak i buforze wejściowym SerialPort obiektu.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Zwraca

String

Zawartość strumienia i bufor SerialPort wejściowy obiektu.

Wyjątki

InvalidOperationException

Podany port nie jest otwarty.

Uwagi

Ta metoda zwraca zawartość strumienia i wewnętrzny bufor SerialPort obiektu jako ciąg. Ta metoda nie używa limitu czasu. Należy pamiętać, że ta metoda może pozostawić końcowe bajty ołowiu w buforze wewnętrznym, co sprawia, że wartość jest BytesToRead większa niż zero.

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

Klasa SerialPort buforuje dane, ale obiekt strumienia SerialPort.BaseStream zawarty we właściwości nie. W związku z SerialPort tym obiekt i obiekt strumienia mogą różnić się od liczby bajtów, które są dostępne do odczytania. Gdy bajty są buforowane do SerialPort obiektu, BytesToRead właściwość zawiera te bajty w swojej wartości. Jednak te bajty mogą nie być dostępne dla strumienia zawartego BaseStream we właściwości.