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 für den seriellen Port.
Überlädt
| Name | Beschreibung |
|---|---|
| Write(String) |
Schreibt die angegebene Zeichenfolge in den seriellen Port. |
| Write(Byte[], Int32, Int32) |
Schreibt eine angegebene Anzahl von Bytes in den seriellen Port mithilfe von Daten aus einem Puffer. |
| Write(Char[], Int32, Int32) |
Schreibt eine angegebene Anzahl von Zeichen mithilfe von Daten aus einem Puffer in den seriellen Port. |
Write(String)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Schreibt die angegebene Zeichenfolge in den seriellen Port.
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 Port ist nicht geöffnet.
text ist null.
Der Vorgang wurde vor Ablauf des Timeoutzeitraums nicht abgeschlossen.
Hinweise
Verwenden Sie diese Methode, wenn Sie eine Zeichenfolge als Ausgabe an einen seriellen Port schreiben möchten.
Wenn im Ausgabepuffer zu viele Bytes vorhanden sind und Handshake auf das Objekt festgelegt XOnXOff ist, löst es SerialPort möglicherweise eine TimeoutException Weile aus, bis das Gerät bereit ist, weitere Daten zu akzeptieren.
Wird SerialPort standardmäßig verwendet, ASCIIEncoding um die Zeichen zu codieren. ASCIIEncoding codiert alle Zeichen größer als 127 als (Zeichen)63 oder "?". Um zusätzliche Zeichen in diesem Bereich zu unterstützen, legen Sie Encoding diesen auf UTF8Encoding, UTF32Encodingoder .UnicodeEncoding
Gilt für:
Write(Byte[], Int32, Int32)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Schreibt eine angegebene Anzahl von Bytes in den seriellen Port mithilfe von Daten aus einem Puffer.
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, das die Daten enthält, die in den Port geschrieben werden sollen.
- offset
- Int32
Der nullbasierte Byte-Offset im buffer Parameter, bei dem mit dem Kopieren von Bytes in den Port begonnen werden soll.
- count
- Int32
Die Anzahl der zu schreibenden Bytes.
Ausnahmen
Der buffer Übergebene ist null.
Der angegebene Port ist nicht geöffnet.
Die offset Parameter count befinden sich außerhalb eines gültigen Bereichs des buffer übergebenen Bereichs. Entweder offset oder count ist kleiner als Null.
offset Plus count ist größer als die Länge der buffer.
Der Vorgang wurde vor Ablauf des Timeoutzeitraums nicht abgeschlossen.
Hinweise
Verwenden Sie diese Methode, wenn Sie in einen Bytepuffer schreiben möchten, um eine Ausgabe an einen seriellen Port zu erstellen.
Wenn im Ausgabepuffer zu viele Bytes vorhanden sind und Handshake auf das Objekt festgelegt XOnXOff ist, löst es SerialPort möglicherweise eine TimeoutException Weile aus, 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
- Quelle:
- SerialPort.cs
Schreibt eine angegebene Anzahl von Zeichen mithilfe von Daten aus einem Puffer in den seriellen Port.
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, das die Daten enthält, die in den Port geschrieben werden sollen.
- offset
- Int32
Der nullbasierte Byte-Offset im buffer Parameter, bei dem mit dem Kopieren von Bytes in den Port begonnen werden soll.
- count
- Int32
Die Anzahl der zu schreibenden Zeichen.
Ausnahmen
Der buffer Übergebene ist null.
Der angegebene Port ist nicht geöffnet.
Die offset Parameter count befinden sich außerhalb eines gültigen Bereichs des buffer übergebenen Bereichs. Entweder offset oder count ist kleiner als Null.
offset Plus count ist größer als die Länge der buffer.
Der Vorgang wurde vor Ablauf des Timeoutzeitraums nicht abgeschlossen.
Hinweise
Verwenden Sie diese Methode, wenn Sie in einen Zeichenpuffer schreiben möchten, um eine Ausgabe an einen seriellen Port zu erstellen.
Wenn im Ausgabepuffer zu viele Bytes vorhanden sind und Handshake auf das Objekt festgelegt XOnXOff ist, löst es SerialPort möglicherweise eine TimeoutException Weile aus, bis das Gerät bereit ist, weitere Daten zu akzeptieren.
Wird SerialPort standardmäßig verwendet, ASCIIEncoding um die Zeichen zu codieren. ASCIIEncoding codiert alle Zeichen größer als 127 als (Zeichen)63 oder "?". Um zusätzliche Zeichen in diesem Bereich zu unterstützen, legen Sie Encoding diesen auf UTF8Encoding, UTF32Encodingoder .UnicodeEncoding
