EncodingProvider Třída

Definice

Poskytuje základní třídu pro zprostředkovatele kódování, který poskytuje kódování, která nejsou k dispozici na konkrétní platformě.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

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
Dědičnost
EncodingProvider
Odvozené
Atributy

Poznámky

Zprostředkovatel kódování poskytuje kódování, která nejsou jinak dostupná na konkrétní cílové platformě.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

.NET Framework na ploše Windows podporuje velký počet kódování znaků a znakových stránek.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. Úplný seznam kódování dostupných v .NET Framework na ploše Windows můžete získat zavoláním Encoding.GetEncodings metody.You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. Rozhraní .NET Core, na druhé straně, ve výchozím nastavení podporuje pouze následující kódování:.NET Core, on the other hand, by default supports only the following encodings:

Počínaje .NET Framework 4,6 EncodingProvider je základní třída, která poskytuje jinak nedostupné kódování pro .NET Framework.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Zahrnuje následující kroky:This involves the following steps:

  1. Definujte podtřídu EncodingProvider , která přepíše dvě abstraktní GetEncoding přetížení GetEncoding(Int32) a GetEncoding(String) .Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Tato přetížení vracejí jinak nepodporované kódování pomocí identifikátoru znakové stránky a podle názvu.These overloads return the otherwise unsupported encoding by code page identifier and by name. Všimněte si, že můžete také vrátit výchozí kódování, pokud GetEncoding(Int32) je metoda volána s argumentem 0.Note that you can also choose to return a default encoding if the GetEncoding(Int32) method is called with an argument of 0.

  2. Volitelně můžete přepsat virtuální GetEncoding(Int32, EncoderFallback, DecoderFallback) a GetEncoding(String, EncoderFallback, DecoderFallback) metody.Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. Ve většině případů to není nutné, protože základní třída poskytuje výchozí implementaci.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Předání EncodingProvider instance Encoding.RegisterProvider metodě, aby bylo kódování poskytované EncodingProvider objektem k dispozici pro modul CLR (Common Language Runtime).Pass the EncodingProvider instance to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.

  4. Encoding.GetEncodingPro načtení kódování zavolejte přetížení.Call an Encoding.GetEncoding overload to retrieve the encoding. Encoding.GetEncodingMetoda zavolá odpovídající, EncodingProvider.GetEncoding aby určila, zda může dodat požadované kódování.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

Knihovna tříd .NET Framework poskytuje jednu statickou vlastnost, CodePagesEncodingProvider.Instance která vrací EncodingProvider objekt, který zpřístupňuje úplnou sadu kódování v knihovně tříd desktopové .NET Framework dostupné .NET Core.NET Core aplikacím.The .NET Framework Class Library provides one static property, CodePagesEncodingProvider.Instance, that returns an EncodingProvider object that makes the full set of encodings available on the desktop .NET Framework Class Library available to .NET Core.NET Core applications. Kromě toho můžete odvodit z třídy, EncodingProvider aby byly dostupné vlastní kódování.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Konstruktory

EncodingProvider()

Inicializuje novou instanci EncodingProvider třídy.Initializes a new instance of the EncodingProvider class.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetEncoding(Int32)

Vrátí kódování přidružené k zadanému identifikátoru znakové stránky.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Vrátí kódování přidružené k zadanému identifikátoru znakové stránky.Returns the encoding associated with the specified code page identifier. Parametry určují obslužnou rutinu chyb pro znaky, které nelze kódovat, a posloupnosti bajtů, které nelze dekódovat.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String)

Vrátí kódování se zadaným názvem.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback)

Vrátí kódování přidružené k zadanému názvu.Returns the encoding associated with the specified name. Parametry určují obslužnou rutinu chyb pro znaky, které nelze kódovat, a posloupnosti bajtů, které nelze dekódovat.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncodings()

Vrátí pole, které obsahuje všechna kódování podporovaná EncodingProvider .Returns an array that contains all the encodings that are supported by the EncodingProvider.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Platí pro

Viz také