Encoding.GetEncoder Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Po zastąpieniu w klasie pochodnej uzyskuje koder, który konwertuje sekwencję znaków Unicode na zakodowaną sekwencję bajtów.
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
Zwraca
Element Encoder , który konwertuje sekwencję znaków Unicode na zakodowaną sekwencję bajtów.
Uwagi
Metoda Encoder.GetBytes konwertuje sekwencyjne bloki znaków na sekwencyjne bloki bajtów w sposób podobny do GetBytes metody tej klasy. Jednak element Encoder zachowuje informacje o stanie między wywołaniami, aby poprawnie kodować sekwencje znaków obejmujące bloki. Obiekt Encoder zachowuje również końcowe znaki na końcu bloków danych i używa końcowych znaków w następnej operacji kodowania. Na przykład blok danych może kończyć się niedopasowanym wysokim zastępcą, a pasujący niski surogat może znajdować się w następnym bloku danych. W związku z tym i GetEncoder są przydatne w przypadku operacji transmisji i plików w sieci, GetDecoder ponieważ te operacje często zajmują się blokami danych zamiast pełnego strumienia danych.
Uwagi dotyczące dziedziczenia
Domyślna implementacja zwraca wartość , Encoder która wywołuje GetByteCount(Char[]) metody i GetBytes(Char[]) bieżącego Encodingelementu . Należy zastąpić tę metodę, aby zwrócić element Encoder , który zachowuje stan między wywołaniami.