Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

SerialPort.ReadChar-Methode

Aktualisiert: November 2007

Liest synchron ein Zeichen aus dem SerialPort-Eingabepuffer.

Namespace:  System.IO.Ports
Assembly:  System (in System.dll)

public int ReadChar()
public int ReadChar()
public function ReadChar() : int

Rückgabewert

Typ: System.Int32
Das Zeichen, das gelesen wurde.

AusnahmeBedingung
InvalidOperationException

Der angegebene Anschluss ist nicht offen.

TimeoutException

Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.

- oder -

Im zugewiesenen Timeoutzeitraum war kein Zeichen verfügbar.

Diese Methode liest auf Grundlage der Codierung ein vollständiges Zeichen.

Verwenden Sie ReadByte und ReadChar zusammen nur vorsichtig. Das Wechseln zwischen dem Lesen von Bytes und dem Lesen von Zeichen kann dazu führen, dass zusätzliche Daten gelesen werden und/oder unbeabsichtigtes Verhalten auftritt. Wenn es erforderlich ist, zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Stream zu wechseln, wählen Sie ein Protokoll aus, dass die Grenze zwischen Text und Binärdaten genau definiert, beispielsweise durch manuelles Lesen von Bytes und Entschlüsseln von Daten.

acd8tt0b.alert_note(de-de,VS.90).gifHinweis:

Da die SerialPort-Klasse Daten puffert, der in der BaseStream-Eigenschaft enthaltene Stream jedoch nicht, gibt es möglicherweise Konflikte dahingehend, wie viele Bytes gelesen werden können. Die BytesToRead-Eigenschaft kann angeben, dass zwar Bytes zum Lesen vorhanden sind, der in der BaseStream-Eigenschaft enthaltene Stream aber möglicherweise nicht auf diese Bytes zugreifen kann, da sie in der SerialPort-Klasse gepuffert wurden.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0
Anzeigen: