EncodingProvider Klasa

Definicja

Przestrzeń nazw:

System.Text

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

EncodingProvider.cs

Udostępnia klasę bazową dla dostawcy kodowania, który dostarcza kodowanie, które są niedostępne na określonej platformie.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Dziedziczenie

Object

EncodingProvider

Pochodne

System.Text.CodePagesEncodingProvider

Uwagi

Dostawca kodowania dostarcza kodowanie, które nie są w inny sposób dostępne na określonej platformie docelowej.

Program .NET Framework obsługuje dużą liczbę kodowań znaków i stron kodu. Pełną listę kodowań dostępnych w programie .NET Framework można uzyskać, wywołując metodę Encoding.GetEncodings . Z drugiej strony platforma .NET Core domyślnie obsługuje tylko następujące kodowanie:

• ASCII (strona kodowa 20127), która jest zwracana przez Encoding.ASCII właściwość .

• ISO-8859-1 (strona kodowa 28591).

• UTF-7 (strona kodowa 65000), która jest zwracana przez Encoding.UTF7 właściwość .

• UTF-8 (strona kodowa 65001), która jest zwracana przez Encoding.UTF8 właściwość .

• UTF-16 i UTF-16LE (strona kodowa 1200), która jest zwracana przez Unicode właściwość .

• UTF-16BE (strona kodowa 1201), która jest tworzone przez wywołanie konstruktora UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) lub UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) z wartością bigEndiantrue.

• UTF-32 i UTF-32LE (strona kodowa 12000), która jest zwracana przez Encoding.UTF32 właściwość .

• UTF-32BE (strona kodowa 12001), która jest tworzone przez wywołanie UTF32Encoding konstruktora z parametrem bigEndian i podanie wartości true w wywołaniu metody.

Począwszy od programu .NET Framework 4.6, jest klasą bazową, która sprawia, EncodingProvider że w przeciwnym razie niedostępne kodowania są dostępne dla programu .NET Framework. Obejmuje to następujące kroki:

1. Zdefiniuj podklasę EncodingProvider , która zastępuje dwa abstrakcyjne GetEncoding przeciążenia i GetEncoding(Int32)GetEncoding(String). Te przeciążenia zwracają nieobsługiwane kodowanie przez identyfikator strony kodowej i według nazwy. Pamiętaj, że można również zwrócić kodowanie domyślne, jeśli GetEncoding(Int32) metoda jest wywoływana z argumentem 0.

2. Opcjonalnie można zastąpić metody i GetEncoding(String, EncoderFallback, DecoderFallback) wirtualneGetEncoding(Int32, EncoderFallback, DecoderFallback). W większości przypadków nie jest to konieczne, ponieważ klasa podstawowa zapewnia domyślną implementację.

3. EncodingProvider Przekaż wystąpienie do Encoding.RegisterProvider metody , aby kodowanie dostarczone przez EncodingProvider obiekt było dostępne dla środowiska uruchomieniowego języka wspólnego.

4. Wywołaj przeciążenie, Encoding.GetEncoding aby pobrać kodowanie. Metoda Encoding.GetEncoding wywoła odpowiedni EncodingProvider.GetEncoding element, aby określić, czy może dostarczyć żądane kodowanie.

Biblioteka klas programu .NET Framework udostępnia jedną statyczną EncodingProvider właściwość , CodePagesEncodingProvider.Instancektóra zwraca obiekt, który udostępnia pełny zestaw kodowań w bibliotece klas programu .NET Framework dla komputerów stacjonarnych dostępnych dla aplikacji platformy .NET Core. Ponadto możesz pochodzić z EncodingProvider klasy, aby udostępnić własne kodowanie.

Konstruktory

Nazwa	Opis
EncodingProvider()	Inicjuje nowe wystąpienie klasy EncodingProvider.

Metody

Nazwa	Opis
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.
GetEncoding(Int32)	Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej.
GetEncoding(String, EncoderFallback, DecoderFallback)	Zwraca kodowanie skojarzone z określoną nazwą. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.
GetEncoding(String)	Zwraca kodowanie z określoną nazwą.
GetEncodings()	Zwraca tablicę zawierającą wszystkie kodowanie obsługiwane przez element EncodingProvider.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• GetEncoding(String)
• Instance