Freigeben über


SerialPort.Write Methode

Definition

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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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.

Gilt für: