Udostępnij za pośrednictwem


EncodingProvider Klasa

Definicja

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
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Dziedziczenie
EncodingProvider
Pochodne
Atrybuty

Uwagi

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

.NET Framework obsługuje dużą liczbę kodowań znaków i stron kodowych. Pełną listę kodowań dostępnych w .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 kodowania:

  • 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 .NET Framework 4.6, jest klasą bazową, która sprawia, EncodingProvider że w przeciwnym razie niedostępne kodowania są dostępne dla .NET Framework. Obejmuje to następujące kroki:

  1. Zdefiniuj podklasę EncodingProvider , która zastępuje dwa abstrakcyjne GetEncoding przeciążenia, GetEncoding(Int32) i GetEncoding(String). Te przeciążenia zwracają nieobsługiwane kodowanie przez identyfikator strony kodowej i według nazwy. Pamiętaj, że możesz również zwrócić domyślne kodowanie, 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 bazowa 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 .NET Framework udostępnia jedną właściwość statyczną EncodingProvider , CodePagesEncodingProvider.Instancektóra zwraca obiekt, który udostępnia pełny zestaw kodowań na pulpicie .NET Framework biblioteki klas dostępnych dla aplikacji platformy .NET Core. Ponadto możesz pochodzić z EncodingProvider klasy , aby udostępnić własne kodowanie.

Konstruktory

EncodingProvider()

Inicjuje nowe wystąpienie klasy EncodingProvider.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetEncoding(Int32)

Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej.

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(String)

Zwraca kodowanie z określoną nazwą.

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ć.

GetEncodings()

Zwraca tablicę zawierającą wszystkie kodowanie obsługiwane przez klasę EncodingProvider.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też