EncodingProvider Třída

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

EncodingProvider.cs

Poskytuje základní třídu pro zprostředkovatele kódování, která poskytuje kódování, která nejsou k dispozici na konkrétní platformě.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Dědičnost

Object

EncodingProvider

Odvozené

System.Text.CodePagesEncodingProvider

Poznámky

Poskytovatel kódování poskytuje kódování, která nejsou jinak dostupná na konkrétní cílové platformě.

Rozhraní .NET Framework podporuje velký počet kódování znaků a znakových stránek. Úplný seznam kódování dostupných v rozhraní .NET Framework můžete získat voláním Encoding.GetEncodings metody. .NET Core naopak ve výchozím nastavení podporuje pouze následující kódování:

• ASCII (znaková stránka 20127), která je vrácena Encoding.ASCII vlastností.

• ISO-8859-1 (znaková stránka 28591).

• UTF-7 (znaková stránka 65000), která je vrácena Encoding.UTF7 vlastností.

• UTF-8 (znaková stránka 65001), která je vrácena Encoding.UTF8 vlastností.

• UTF-16 a UTF-16LE (znaková stránka 1200), která je vrácena Unicode vlastností.

• UTF-16BE (znaková stránka 1201), která je vytvořena voláním UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) nebo UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) konstruktoru bigEndian s hodnotou true.

• UTF-32 a UTF-32LE (znaková stránka 12000), která je vrácena Encoding.UTF32 vlastností.

• UTF-32BE (znaková stránka 12001), která je vytvořena voláním UTF32Encoding konstruktoru bigEndian , který má parametr a poskytuje hodnotu true volání metody.

Počínaje rozhraním .NET Framework 4.6 je základní třída, EncodingProvider která zpřístupňuje jinak nedostupné kódování pro rozhraní .NET Framework. To zahrnuje následující kroky:

1. Definujte podtřídu EncodingProvider , která přepíše dvě abstraktní GetEncoding přetížení, GetEncoding(Int32) a GetEncoding(String). Tato přetížení vrací jinak nepodporované kódování podle identifikátoru znakové stránky a podle názvu. Všimněte si, že pokud je metoda volána s argumentem 0, můžete také vrátit výchozí kódování GetEncoding(Int32) .

2. Volitelně můžete přepsat virtuální GetEncoding(Int32, EncoderFallback, DecoderFallback) a GetEncoding(String, EncoderFallback, DecoderFallback) metody. Ve většině případů to není nutné, protože základní třída poskytuje výchozí implementaci.

3. EncodingProvider Předejte instanci Encoding.RegisterProvider metodě, aby kódování zadané objektem EncodingProvider bylo k dispozici modulu CLR (Common Language Runtime).

4. Volání přetížení Encoding.GetEncoding pro načtení kódování. Metoda Encoding.GetEncoding zavolá odpovídající EncodingProvider.GetEncoding k určení, zda může poskytnout požadované kódování.

Knihovna tříd rozhraní .NET Framework poskytuje jednu statickou vlastnost, CodePagesEncodingProvider.Instancekterá vrací EncodingProvider objekt, který zpřístupňuje úplnou sadu kódování v desktopové knihovně tříd rozhraní .NET Framework k dispozici pro aplikace .NET Core. Kromě toho můžete odvodit z EncodingProvider třídy, aby byly k dispozici vlastní kódování.

Konstruktory

Name	Description
EncodingProvider()	Inicializuje novou instanci EncodingProvider třídy.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Vrátí kódování přidružené k zadanému identifikátoru znakové stránky. Parametry určují obslužnou rutinu chyby pro znaky, které nelze kódovat, a bajtové sekvence, které nelze dekódovat.
GetEncoding(Int32)	Vrátí kódování přidružené k zadanému identifikátoru znakové stránky.
GetEncoding(String, EncoderFallback, DecoderFallback)	Vrátí kódování přidružené k zadanému názvu. Parametry určují obslužnou rutinu chyby pro znaky, které nelze kódovat, a bajtové sekvence, které nelze dekódovat.
GetEncoding(String)	Vrátí kódování se zadaným názvem.
GetEncodings()	Vrátí pole, které obsahuje všechna kódování podporovaná funkcí EncodingProvider.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• GetEncoding(String)
• Instance