SerialPort.ReadByte 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 wordt één byte gelezen uit de SerialPort invoerbuffer.
public:
int ReadByte();public int ReadByte();member this.ReadByte : unit -> intPublic Function ReadByte () As IntegerRetouren
De byte, cast naar een Int32of -1 als het einde van de stream is gelezen.
Uitzonderingen
De opgegeven poort is niet geopend.
De bewerking is niet voltooid voordat de time-outperiode is beëindigd.
– of –
Geen byte was gelezen.
Opmerkingen
Met deze methode wordt één byte gelezen.
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.