SerialPort.Write Methode

Definition

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

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

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

InvalidOperationException

Der angegebene Anschluss ist nicht offen.

ArgumentNullException

text ist null.

TimeoutException

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.

Write(Byte[], Int32, Int32)

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

ArgumentNullException

Der übergebene buffer ist null.

InvalidOperationException

Der angegebene Anschluss ist nicht offen.

ArgumentOutOfRangeException

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).

ArgumentException

Die Summe von offset und count ist größer als die Länge von buffer.

TimeoutException

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.

Write(Char[], Int32, Int32)

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

ArgumentNullException

Der übergebene buffer ist null.

InvalidOperationException

Der angegebene Anschluss ist nicht offen.

ArgumentOutOfRangeException

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).

ArgumentException

Die Summe von offset und count ist größer als die Länge von buffer.

TimeoutException

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.