Udostępnij za pośrednictwem


SerialPort.ReadExisting Metoda

Definicja

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

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

Wyjątki

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.

Dotyczy