EncodingProvider Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
[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 k dispozici 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 získáte voláním Encoding.GetEncodings metody . .NET Core naopak ve výchozím nastavení podporuje pouze následující kódování:
ASCII (kódová stránka 20127), která je vrácena Encoding.ASCII vlastností .
ISO-8859-1 (znaková stránka 28591).
UTF-7 (kódová stránka 65000), která je vrácena Encoding.UTF7 vlastností.
UTF-8 (kódová stránka 65001), která je vrácena Encoding.UTF8 vlastností.
UTF-16 a UTF-16LE (znaková stránka 1200), které vrátí Unicode vlastnost.
UTF-16BE (kódová stránka 1201), která se vytvoří voláním konstruktoru UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) nebo UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) s
bigEndian
hodnotoutrue
.UTF-32 a UTF-32LE (znaková stránka 12000), které vrátí Encoding.UTF32 vlastnost.
UTF-32BE (znaková stránka 12001), která je vytvořena voláním konstruktoru UTF32Encoding
bigEndian
, který má parametr a poskytuje hodnotutrue
ve 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:
Definujte podtřídu , EncodingProvider která přepíše dvě abstraktní GetEncoding přetížení GetEncoding(Int32) , a GetEncoding(String). Tato přetížení vrátí 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é zvolit vrácení výchozího kódování GetEncoding(Int32) .
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.
EncodingProvider Předejte instanci Encoding.RegisterProvider metodě, aby byla kódování zadaná objektem EncodingProvider k dispozici modulu CLR (Common Language Runtime).
Voláním Encoding.GetEncoding přetížení načtěte kódování. Metoda Encoding.GetEncoding bude volat 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 pro aplikace .NET Core. Kromě toho můžete odvodit z EncodingProvider třídy a zpřístupnit tak vlastní kódování.
Konstruktory
EncodingProvider() |
Inicializuje novou instanci EncodingProvider třídy . |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetEncoding(Int32) |
Vrátí kódování přidružené k zadanému identifikátoru znakové stránky. |
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 zakódovat, a sekvence bajtů, které nelze dekódovat. |
GetEncoding(String) |
Vrátí kódování se zadaným názvem. |
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 zakódovat, a sekvence bajtů, které nelze dekódovat. |
GetEncodings() |
Vrátí pole obsahující všechna kódování podporovaná objektem EncodingProvider. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |