Encoding.GetEncoder Encoding.GetEncoder Encoding.GetEncoder Encoding.GetEncoder Method

Definition

Beim Überschreiben in einer abgeleiteten Klasse wird ein Encoder abgerufen, der eine Folge von Unicode-Zeichen in eine codierte Bytefolge konvertiert.When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.

public:
 virtual System::Text::Encoder ^ GetEncoder();
public virtual System.Text.Encoder GetEncoder ();
abstract member GetEncoder : unit -> System.Text.Encoder
override this.GetEncoder : unit -> System.Text.Encoder
Public Overridable Function GetEncoder () As Encoder

Gibt zurück

Ein Encoder, der eine Folge von Unicode-Zeichen in eine codierte Bytefolge konvertiert.A Encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.

Hinweise

Die Encoder.GetBytes -Methode konvertiert sequenzielle Zeichenblöcke in eine Weise, die der GetBytes -Methode dieser Klasse ähnelt, in sequenzielle Byte Blöcke.The Encoder.GetBytes method converts sequential blocks of characters into sequential blocks of bytes, in a manner similar to the GetBytes method of this class. Eine Encoder verwaltet jedoch Zustandsinformationen zwischen aufrufen, sodass Sie Zeichen folgen, die Blöcke spannen, ordnungsgemäß codiert.However, a Encoder maintains state information between calls so it correctly encodes character sequences that span blocks. Behält Encoder auch nachfolgende Zeichen am Ende der Datenblöcke bei und verwendet die nachfolgenden Zeichen im nächsten Codierungs Vorgang.The Encoder also preserves trailing characters at the end of data blocks and uses the trailing characters in the next encoding operation. Beispielsweise kann ein Datenblock mit einem nicht übereinstimmenden hohen Ersatz Zeichen enden, und das entsprechende niedrige Ersatz Zeichen kann sich im nächsten Datenblock befinden.For example, a data block might end with an unmatched high surrogate, and the matching low surrogate might be in the next data block. Daher sind GetEncoder und für die Netzwerkübertragung und Datei Vorgänge nützlich, da diese Vorgänge häufig Datenblöcke anstelle eines gesamten Datenstroms behandeln. GetDecoderTherefore, GetDecoder and GetEncoder are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.

Hinweise für Vererber

Die Standard Implementierung gibt einen Encoder zurück, der GetByteCount(Char[]) die GetBytes(Char[]) -Methode und die Encoding-Methode der aktuellen aufruft.The default implementation returns a Encoder that calls the GetByteCount(Char[]) and GetBytes(Char[]) methods of the current Encoding. Sie müssen diese Methode überschreiben, um Encoder einen zurückzugeben, der seinen Zustand zwischen Aufrufen beibehält.You must override this method to return a Encoder that maintains its state between calls.

Gilt für:

Siehe auch