SerialPort.Read 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.
Liest aus dem SerialPort Eingabepuffer.
Überlädt
| Name | Beschreibung |
|---|---|
| Read(Byte[], Int32, Int32) |
Liest eine Anzahl von Bytes aus dem SerialPort Eingabepuffer und schreibt diese Bytes in ein Bytearray im angegebenen Offset. |
| Read(Char[], Int32, Int32) |
Liest eine Reihe von Zeichen aus dem SerialPort Eingabepuffer und schreibt sie in ein Array von Zeichen in einem bestimmten Offset. |
Read(Byte[], Int32, Int32)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Liest eine Anzahl von Bytes aus dem SerialPort Eingabepuffer und schreibt diese Bytes in ein Bytearray im angegebenen Offset.
public:
int Read(cli::array <System::Byte> ^ buffer, int offset, int count);public int Read(byte[] buffer, int offset, int count);member this.Read : byte[] * int * int -> intPublic Function Read (buffer As Byte(), offset As Integer, count As Integer) As IntegerParameter
- buffer
- Byte[]
Das Bytearray, in das die Eingabe geschrieben werden soll.
- offset
- Int32
Der Offset, in buffer dem die Bytes geschrieben werden sollen.
- count
- Int32
Die maximale Anzahl der zu lesenden Bytes. Weniger Bytes werden gelesen, wenn count die Anzahl der Bytes im Eingabepuffer größer ist.
Gibt zurück
Die Anzahl der gelesenen Bytes.
Ausnahmen
Der übergebene Puffer 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.
Zum Lesen waren keine Bytes verfügbar.
Hinweise
Wenn es erforderlich ist, zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Datenstrom zu wechseln, wählen Sie ein Protokoll aus, das die Grenze zwischen Text und Binären Daten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodieren der Daten.
Da die SerialPort Klassendaten und der in der BaseStream Eigenschaft enthaltene Datenstrom nicht gepuffert werden, stehen möglicherweise Konflikte zwischen den beiden Bytes zum Lesen zur Verfügung. Die BytesToRead Eigenschaft kann angeben, dass Bytes gelesen werden sollen, aber auf diese Bytes kann möglicherweise nicht auf den in der BaseStream Eigenschaft enthaltenen Datenstrom zugegriffen werden, da sie in der SerialPort Klasse gepuffert wurden.
Die Read Methode blockiert keine anderen Vorgänge, wenn die Anzahl der gelesenen Bytes gleich ist count , aber noch ungelesene Bytes im seriellen Port verfügbar sind.
Gilt für:
Read(Char[], Int32, Int32)
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
- Quelle:
- SerialPort.cs
Liest eine Reihe von Zeichen aus dem SerialPort Eingabepuffer und schreibt sie in ein Array von Zeichen in einem bestimmten Offset.
public:
int Read(cli::array <char> ^ buffer, int offset, int count);public int Read(char[] buffer, int offset, int count);member this.Read : char[] * int * int -> intPublic Function Read (buffer As Char(), offset As Integer, count As Integer) As IntegerParameter
- buffer
- Char[]
Das Zeichenarray, in das die Eingabe geschrieben werden soll.
- offset
- Int32
Der Offset, in buffer dem die Zeichen geschrieben werden sollen.
- count
- Int32
Die maximale Anzahl zu lesenden Zeichen. Weniger Zeichen werden gelesen, wenn count die Anzahl der Zeichen im Eingabepuffer größer ist.
Gibt zurück
Die Anzahl der gelesenen Zeichen.
Ausnahmen
offset Plus count ist größer als die Länge des Puffers.
- oder -
count ist 1 und es gibt ein Ersatzzeichen im Puffer.
Der buffer Übergebene ist null.
Die offset Parameter count befinden sich außerhalb eines gültigen Bereichs des buffer übergebenen Bereichs. Entweder offset oder count ist kleiner als Null.
Der angegebene Port ist nicht geöffnet.
Es waren keine Zeichen zum Lesen verfügbar.
Hinweise
Verwenden Sie diese Methode zum Lesen von Zeichen aus dem seriellen Port.
Wenn es erforderlich ist, zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Datenstrom zu wechseln, wählen Sie ein Protokoll aus, das die Grenze zwischen Text und Binären Daten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodieren der Daten.
Da die SerialPort Klassendaten und der in der BaseStream Eigenschaft enthaltene Datenstrom nicht gepuffert werden, stehen möglicherweise Konflikte zwischen den beiden Zeichen zum Lesen zur Verfügung. Die BytesToRead Eigenschaft kann angeben, dass es Zeichen gibt, die gelesen werden sollen, aber diese Zeichen sind möglicherweise nicht für den in der BaseStream Eigenschaft enthaltenen Datenstrom zugänglich, da sie in der SerialPort Klasse gepuffert wurden.
Die Read Methode blockiert keine anderen Vorgänge, wenn die Anzahl der gelesenen Bytes gleich ist count , aber noch ungelesene Bytes im seriellen Port verfügbar sind.
