Encoding.GetEncoder-Methode
Beim Überschreiben in einer abgeleiteten Klasse wird ein Encoder abgerufen, der eine Folge von Unicode-Zeichen in eine codierte Bytefolge konvertiert.
Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overridable Function GetEncoder As Encoder
'Usage
Dim instance As Encoding
Dim returnValue As Encoder
returnValue = instance.GetEncoder
public virtual Encoder GetEncoder ()
public:
virtual Encoder^ GetEncoder ()
public Encoder GetEncoder ()
public function GetEncoder () : Encoder
Rückgabewert
Eine Encoder-Klasse, die eine Folge von Unicode-Zeichen in eine codierte Bytefolge konvertiert.
Hinweise
Ähnlich wie die GetBytes-Methode dieser Klasse konvertiert die Encoder.GetBytes-Methode sequenzielle Blöcke von Zeichen in sequenzielle Blöcke von Bytes. Eine Encoder-Klasse behält jedoch Zustandsinformationen zwischen Aufrufen bei, damit Zeichenfolgen, die mehrere Blöcke umfassen, korrekt codiert werden können. Die Encoder-Klasse behält nachfolgende Zeichen am Ende von Datenblöcken bei und verwendet diese im nächsten Codierungsvorgang. So kann ein Datenblock beispielsweise mit einem hohen Ersatzzeichen ohne Entsprechung enden, während sich das entsprechende niedrige Ersatzzeichen im nächsten Datenblock befindet. 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 Encoder-Klasse zurück, die einfach die GetByteCount-Methode und die GetBytes-Methode der aktuellen Encoding-Klasse aufruft. Sie müssen diese Methode überschreiben, um eine Encoder-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
Encoder-Klasse
GetBytes
GetByteCount
GetDecoder