Encoding.GetDecoder-Methode

Artikel
08/20/2007

Beim Überschreiben in einer abgeleiteten Klasse wird ein Decoder abgerufen, der eine codierte Bytefolge in Zeichen konvertiert.

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable Function GetDecoder As Decoder
'Usage
Dim instance As Encoding
Dim returnValue As Decoder

returnValue = instance.GetDecoder

public virtual Decoder GetDecoder ()

public:
virtual Decoder^ GetDecoder ()

public Decoder GetDecoder ()

public function GetDecoder () : Decoder

Rückgabewert

Eine Decoder-Klasse, die eine codierte Bytefolge in eine Folge von Zeichen codiert.

Hinweise

Ähnlich wie die GetChars-Methode dieser Klasse konvertiert die Decoder.GetChars-Methode sequenzielle Blöcke von Bytes in sequenzielle Blöcke von Zeichen. Eine Decoder-Klasse erhält jedoch die Zustandsinformationen zwischen Aufrufen aufrecht, damit Blöcke umfassende Bytefolgen korrekt decodiert werden können. Die Decoder-Klasse behält nachfolgende Bytes am Ende von Datenblöcken bei und verwendet sie im nächsten Decodierungsvorgang. Deshalb empfehlen sich GetDecoder und GetEncoder für Netzwerkübertragungs- und Dateivorgänge, da diese Vorgänge oft mit Datenblöcken und nicht mit vollständigen Datenstreams arbeiten.

Hinweise für Implementierer Die Standardimplementierung gibt eine Decoder-Klasse zurück, die einfach die GetCharCount-Methode und die GetChars-Methode der aktuellen Encoding-Klasse aufruft. Sie müssen diese Methode überschreiben, um eine Decoder-Klasse zurückzugeben, die den Zustand zwischen Aufrufen beibehält.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Encoding-Klasse
Encoding-Member
System.Text-Namespace
Decoder-Klasse
GetChars
GetString
GetCharCount
GetEncoder

Freigeben über