SerialPort.Write Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt Daten in den Ausgabepuffer des seriellen Anschlusses.
Überlädt
| Write(String) |
Schreibt die angegebene Zeichenfolge in den seriellen Anschluss. |
| Write(Byte[], Int32, Int32) |
Schreibt eine angegebene Anzahl von Bytes unter Verwendung von Daten aus einem Puffer in den seriellen Anschluss. |
| Write(Char[], Int32, Int32) |
Schreibt eine angegebene Anzahl von Zeichen unter Verwendung von Daten aus einem Puffer in den seriellen Anschluss. |
Write(String)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Schreibt die angegebene Zeichenfolge in den seriellen Anschluss.
public:
void Write(System::String ^ text);public void Write (string text);member this.Write : string -> unitPublic Sub Write (text As String)Parameter
- text
- String
Die Zeichenfolge für die Ausgabe.
Ausnahmen
Der angegebene Anschluss ist nicht offen.
text ist null.
Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.
Hinweise
Verwenden Sie diese Methode, wenn Sie eine Zeichenfolge als Ausgabe an einen seriellen Port schreiben möchten.
Wenn der Ausgabepuffer zu viele Bytes enthält und Handshake auf XOnXOff festgelegt ist, löst das SerialPort Objekt möglicherweise eine Weile aus TimeoutException , bis das Gerät bereit ist, weitere Daten zu akzeptieren.
Standardmäßig verwendet ASCIIEncoding , SerialPort um die Zeichen zu codieren. ASCIIEncoding codiert alle Zeichen, die größer als 127 sind, als (char)63 oder "?". Um zusätzliche Zeichen in diesem Bereich zu unterstützen, legen Sie auf UTF8Encoding, UTF32Encodingoder UnicodeEncodingfestEncoding.
Gilt für:
Write(Byte[], Int32, Int32)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Schreibt eine angegebene Anzahl von Bytes unter Verwendung von Daten aus einem Puffer in den seriellen Anschluss.
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)Parameter
- buffer
- Byte[]
Das Bytearray mit den Daten, die an den Anschluss geschrieben werden sollen.
- offset
- Int32
Der nullbasierte Byteoffset im buffer-Parameter, ab dem Bytes in den Anschluss kopiert werden.
- count
- Int32
Die Anzahl der zu schreibenden Bytes.
Ausnahmen
Der übergebene buffer ist null.
Der angegebene Anschluss ist nicht offen.
Der offset-Parameter oder der count-Parameter liegt außerhalb eines gültigen Bereichs des übergebenen buffer. Entweder offset oder count ist kleiner als 0 (null).
Die Summe von offset und count ist größer als die Länge von buffer.
Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.
Hinweise
Verwenden Sie diese Methode, wenn Sie in einen Bytepuffer schreiben möchten, um eine Ausgabe an einen seriellen Port zu erstellen.
Wenn der Ausgabepuffer zu viele Bytes enthält und Handshake auf XOnXOff festgelegt ist, löst das SerialPort Objekt möglicherweise eine Weile aus TimeoutException , bis das Gerät bereit ist, weitere Daten zu akzeptieren.
Gilt für:
Write(Char[], Int32, Int32)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Schreibt eine angegebene Anzahl von Zeichen unter Verwendung von Daten aus einem Puffer in den seriellen Anschluss.
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)Parameter
- buffer
- Char[]
Das Zeichenarray mit den Daten, die an den Anschluss geschrieben werden sollen.
- offset
- Int32
Der nullbasierte Byteoffset im buffer-Parameter, ab dem Bytes in den Anschluss kopiert werden.
- count
- Int32
Die Anzahl der zu schreibenden Zeichen.
Ausnahmen
Der übergebene buffer ist null.
Der angegebene Anschluss ist nicht offen.
Der offset-Parameter oder der count-Parameter liegt außerhalb eines gültigen Bereichs des übergebenen buffer. Entweder offset oder count ist kleiner als 0 (null).
Die Summe von offset und count ist größer als die Länge von buffer.
Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.
Hinweise
Verwenden Sie diese Methode, wenn Sie in einen Zeichenpuffer schreiben möchten, um eine Ausgabe an einen seriellen Port zu erstellen.
Wenn der Ausgabepuffer zu viele Bytes enthält und Handshake auf XOnXOff festgelegt ist, löst das SerialPort Objekt möglicherweise eine Weile aus TimeoutException , bis das Gerät bereit ist, weitere Daten zu akzeptieren.
Standardmäßig verwendet ASCIIEncoding , SerialPort um die Zeichen zu codieren. ASCIIEncoding codiert alle Zeichen, die größer als 127 sind, als (char)63 oder "?". Um zusätzliche Zeichen in diesem Bereich zu unterstützen, legen Sie auf UTF8Encoding, UTF32Encodingoder UnicodeEncodingfestEncoding.
