SerialPort.ReadTo(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee leest u een tekenreeks tot aan de opgegeven value in de invoerbuffer.
public:
System::String ^ ReadTo(System::String ^ value);public string ReadTo(string value);member this.ReadTo : string -> stringPublic Function ReadTo (value As String) As StringParameters
- value
- String
Een waarde die aangeeft waar de leesbewerking stopt.
Retouren
De inhoud van de invoerbuffer tot aan de opgegeven value.
Uitzonderingen
De lengte van de value parameter is 0.
De value parameter is null.
De opgegeven poort is niet geopend.
De bewerking is niet voltooid voordat de time-outperiode is beëindigd.
Opmerkingen
Met deze methode wordt een tekenreeks naar de opgegeven waarde gelezen value. Hoewel de geretourneerde tekenreeks niet de valuetekenreeks bevat, wordt deze value verwijderd uit de invoerbuffer.
Als het nodig is om te schakelen tussen het lezen van tekst en het lezen van binaire gegevens uit de stroom, selecteert u een protocol dat de grens tussen tekst en binaire gegevens zorgvuldig definieert, zoals het handmatig lezen van bytes en het decoderen van de gegevens.
Note
Omdat de SerialPort klasse gegevens buffert en de stroom in de BaseStream eigenschap niet, kunnen de twee conflicteren over hoeveel bytes er beschikbaar zijn om te lezen. De BytesToRead eigenschap kan aangeven dat er bytes zijn om te lezen, maar deze bytes zijn mogelijk niet toegankelijk voor de stream in de BaseStream eigenschap omdat ze zijn gebufferd naar de SerialPort klasse.
