SerialPort.ReadChar 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.
Leest synchroon één teken uit de SerialPort invoerbuffer.
public:
int ReadChar();public int ReadChar();member this.ReadChar : unit -> intPublic Function ReadChar () As IntegerRetouren
Het teken dat is gelezen.
Uitzonderingen
De opgegeven poort is niet geopend.
De bewerking is niet voltooid voordat de time-outperiode is beëindigd.
– of –
Er was geen teken beschikbaar in de toegewezen time-outperiode.
Opmerkingen
Met deze methode wordt één volledig teken gelezen op basis van de codering.
Wees voorzichtig bij het gebruik ReadByte en ReadChar samen. Als u schakelt tussen leesbytes en leestekens, kunnen extra gegevens worden gelezen en/of ander onbedoeld gedrag. 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.