SerialPort.ReadTo(String) 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 ciąg do określonego value w buforze wejściowym.

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

Parametry

value

String

Wartość wskazująca, gdzie zatrzymuje się operacja odczytu.

Zwraca

String

Zawartość buforu wejściowego do określonego value.

Wyjątki

ArgumentException

Długość parametru value wynosi 0.

ArgumentNullException

Parametr value ma wartość null.

InvalidOperationException

Podany port nie jest otwarty.

TimeoutException

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

Uwagi

Ta metoda odczytuje ciąg do określonego valueelementu . Chociaż zwrócony ciąg nie zawiera value, value element jest usuwany z buforu wejściowego.

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.