EncodingProvider Classe

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Runtime.dll

Origine:

EncodingProvider.cs

Fornisce la classe base per un provider di codifica, che fornisce le codifiche non disponibili in una particolare piattaforma.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Ereditarietà

Object

EncodingProvider

Derivato

System.Text.CodePagesEncodingProvider

Commenti

Un provider di codifica fornisce codifica che non sono altrimenti disponibili in una determinata piattaforma di destinazione.

.NET Framework supporta un numero elevato di codifiche di caratteri e pagine codici. È possibile ottenere un elenco completo di codifica disponibili in .NET Framework chiamando il Encoding.GetEncodings metodo . .NET Core, per impostazione predefinita, supporta solo le codifica seguenti:

• ASCII (tabella codici 20127), restituita dalla Encoding.ASCII proprietà .

• ISO-8859-1 (tabella codici 28591).

• UTF-7 (tabella codici 65000), restituita dalla Encoding.UTF7 proprietà.

• UTF-8 (tabella codici 65001), restituita dalla Encoding.UTF8 proprietà .

• UTF-16 e UTF-16LE (tabella codici 1200), restituito dalla Unicode proprietà.

• UTF-16BE (tabella codici 1201), che viene creata un'istanza chiamando il UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) costruttore o UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) con un bigEndian valore di true.

• UTF-32 e UTF-32LE (tabella codici 12000), restituita dalla Encoding.UTF32 proprietà.

• UTF-32BE (code page 12001), che viene creata un'istanza chiamando un UTF32Encoding costruttore con un bigEndian parametro e fornendo un valore di true nella chiamata al metodo.

A partire da .NET Framework 4.6, EncodingProvider è la classe di base che rende altrimenti non disponibili le codifica disponibili per .NET Framework. Questo include i passaggi seguenti:

1. Definire una sottoclasse di che esegue l'override dei EncodingProvider due overload GetEncoding(Int32) astratti GetEncoding e GetEncoding(String). Questi overload restituiscono la codifica diversamente non supportata in base all'identificatore della tabella codici e al nome. Si noti che è anche possibile scegliere di restituire una codifica predefinita se il GetEncoding(Int32) metodo viene chiamato con un argomento 0.

2. Facoltativamente, è possibile eseguire l'override dei metodi e GetEncoding(String, EncoderFallback, DecoderFallback) virtualiGetEncoding(Int32, EncoderFallback, DecoderFallback). Nella maggior parte dei casi, questa operazione non è necessaria, poiché la classe di base fornisce un'implementazione predefinita.

3. Passare l'istanza EncodingProviderEncoding.RegisterProvider al metodo per rendere disponibili le codifiche fornite dall'oggetto EncodingProvider per Common Language Runtime.

4. Chiamare un Encoding.GetEncoding overload per recuperare la codifica. Il Encoding.GetEncoding metodo chiamerà il corrispondente EncodingProvider.GetEncoding per determinare se può fornire la codifica richiesta.

La libreria di classi .NET Framework fornisce una proprietà statica, , CodePagesEncodingProvider.Instanceche restituisce un EncodingProvider oggetto che rende disponibile il set completo di codifica nella libreria di classi .NET Framework desktop disponibile per le applicazioni .NET Core. È inoltre possibile derivare dalla EncodingProvider classe per rendere disponibili le proprie codifiche.

Costruttori

EncodingProvider()

Inizializza una nuova istanza della classe EncodingProvider.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEncoding(Int32)	Restituisce la codifica associata all'identificatore della tabella codici specificata.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Restituisce la codifica associata all'identificatore della tabella codici specificata. I parametri specificano un gestore errori per i caratteri che non possono essere codificati e per le sequenze di byte che non possono essere decodificate.
GetEncoding(String)	Restituisce la codifica con il nome specificato.
GetEncoding(String, EncoderFallback, DecoderFallback)	Restituisce la codifica associata al nome specificato. I parametri specificano un gestore errori per i caratteri che non possono essere codificati e per le sequenze di byte che non possono essere decodificate.
GetEncodings()	Restituisce una matrice che contiene tutte le codifiche supportate da EncodingProvider.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• GetEncoding(String)
• Instance