SerialPort.Write 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 schrijft u gegevens naar de uitvoerbuffer van de seriële poort.
Overloads
| Name | Description |
|---|---|
| Write(String) |
Hiermee schrijft u de opgegeven tekenreeks naar de seriële poort. |
| Write(Byte[], Int32, Int32) |
Hiermee schrijft u een opgegeven aantal bytes naar de seriële poort met behulp van gegevens uit een buffer. |
| Write(Char[], Int32, Int32) |
Schrijft een opgegeven aantal tekens naar de seriële poort met behulp van gegevens uit een buffer. |
Write(String)
Hiermee schrijft u de opgegeven tekenreeks naar de seriële poort.
public:
void Write(System::String ^ text);public void Write(string text);member this.Write : string -> unitPublic Sub Write (text As String)Parameters
- text
- String
De tekenreeks voor uitvoer.
Uitzonderingen
De opgegeven poort is niet geopend.
text is null.
De bewerking is niet voltooid voordat de time-outperiode is beëindigd.
Opmerkingen
Gebruik deze methode als u een tekenreeks wilt schrijven als uitvoer naar een seriële poort.
Als er te veel bytes in de uitvoerbuffer staan en Handshake is ingesteld op XOnXOff , kan het SerialPort object een TimeoutException tijdje duren voordat het apparaat gereed is om meer gegevens te accepteren.
SerialPort Standaard wordt gebruikt ASCIIEncoding om de tekens te coderen. ASCIIEncoding codeert alle tekens die groter zijn dan 127 als (teken)63 of '?'. Als u extra tekens in dat bereik wilt ondersteunen, stelt u in op EncodingUTF8Encoding, UTF32Encodingof UnicodeEncoding.
Van toepassing op
Write(Byte[], Int32, Int32)
Hiermee schrijft u een opgegeven aantal bytes naar de seriële poort met behulp van gegevens uit een buffer.
public:
void Write(cli::array <System::Byte> ^ buffer, int offset, int count);public void Write(byte[] buffer, int offset, int count);member this.Write : byte[] * int * int -> unitPublic Sub Write (buffer As Byte(), offset As Integer, count As Integer)Parameters
- buffer
- Byte[]
De bytematrix die de gegevens bevat die naar de poort moeten worden geschreven.
- offset
- Int32
De byte-offset op basis van nul in de buffer parameter waarmee bytes naar de poort worden gekopieerd.
- count
- Int32
Het aantal te schrijven bytes.
Uitzonderingen
De buffer doorgegeven is null.
De opgegeven poort is niet geopend.
De offset of count parameters bevinden zich buiten een geldig gebied van de buffer doorgegeven.
count Of offset is kleiner dan nul.
offset plus count is groter dan de lengte van de buffer.
De bewerking is niet voltooid voordat de time-outperiode is beëindigd.
Opmerkingen
Gebruik deze methode als u naar een bytebuffer wilt schrijven om uitvoer naar een seriële poort te maken.
Als er te veel bytes in de uitvoerbuffer staan en Handshake is ingesteld op XOnXOff , kan het SerialPort object een TimeoutException tijdje duren voordat het apparaat gereed is om meer gegevens te accepteren.
Van toepassing op
Write(Char[], Int32, Int32)
Schrijft een opgegeven aantal tekens naar de seriële poort met behulp van gegevens uit een buffer.
public:
void Write(cli::array <char> ^ buffer, int offset, int count);public void Write(char[] buffer, int offset, int count);member this.Write : char[] * int * int -> unitPublic Sub Write (buffer As Char(), offset As Integer, count As Integer)Parameters
- buffer
- Char[]
De tekenmatrix die de gegevens bevat die naar de poort moeten worden geschreven.
- offset
- Int32
De byte-offset op basis van nul in de buffer parameter waarmee bytes naar de poort worden gekopieerd.
- count
- Int32
Het aantal tekens dat moet worden geschreven.
Uitzonderingen
De buffer doorgegeven is null.
De opgegeven poort is niet geopend.
De offset of count parameters bevinden zich buiten een geldig gebied van de buffer doorgegeven.
count Of offset is kleiner dan nul.
offset plus count is groter dan de lengte van de buffer.
De bewerking is niet voltooid voordat de time-outperiode is beëindigd.
Opmerkingen
Gebruik deze methode als u naar een tekenbuffer wilt schrijven om uitvoer naar een seriële poort te maken.
Als er te veel bytes in de uitvoerbuffer staan en Handshake is ingesteld op XOnXOff , kan het SerialPort object een TimeoutException tijdje duren voordat het apparaat gereed is om meer gegevens te accepteren.
SerialPort Standaard wordt gebruikt ASCIIEncoding om de tekens te coderen. ASCIIEncoding codeert alle tekens die groter zijn dan 127 als (teken)63 of '?'. Als u extra tekens in dat bereik wilt ondersteunen, stelt u in op EncodingUTF8Encoding, UTF32Encodingof UnicodeEncoding.