EncodingProvider Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce la classe base per un provider di codifica, che fornisce codifiche non disponibili in una determinata piattaforma.
public ref class EncodingProvider abstractpublic abstract class EncodingProvider[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvidertype EncodingProvider = class[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = classPublic MustInherit Class EncodingProvider- Ereditarietà
-
EncodingProvider
- Derivato
- Attributi
Commenti
Un provider di codifica fornisce codifiche che non sono altrimenti disponibili in una determinata piattaforma di destinazione.
.NET Framework supporta un numero elevato di codifiche di caratteri e tabelle codici. È possibile ottenere un elenco completo delle codifiche disponibili in .NET Framework chiamando il Encoding.GetEncodings metodo . .NET Core, d'altra parte, per impostazione predefinita supporta solo le codifiche 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), restituita dalla Unicode proprietà .
UTF-16BE (tabella codici 1201), di cui viene creata un'istanza chiamando il UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) costruttore o UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) con il
bigEndianvaloretrue.UTF-32 e UTF-32LE (tabella codici 12000), restituita dalla Encoding.UTF32 proprietà .
UTF-32BE (tabella codici 12001), di cui viene creata un'istanza chiamando un UTF32Encoding costruttore con un
bigEndianparametro e fornendo un valore ditruenella chiamata al metodo.
A partire da .NET Framework 4.6, EncodingProvider è la classe base che rende disponibili codifiche altrimenti non disponibili per .NET Framework. Questa operazione prevede i passaggi seguenti:
Definire una sottoclasse di EncodingProvider che esegue l'override dei due overload astratti GetEncoding e GetEncoding(Int32)GetEncoding(String). Questi overload restituiscono la codifica diversamente non supportata dall'identificatore della tabella codici e dal nome. Si noti che è anche possibile scegliere di restituire una codifica predefinita se il GetEncoding(Int32) metodo viene chiamato con un argomento pari a 0.
Facoltativamente, è possibile eseguire l'override dei metodi e GetEncoding(String, EncoderFallback, DecoderFallback) virtualiGetEncoding(Int32, EncoderFallback, DecoderFallback). Nella maggior parte dei casi, ciò non è necessario, poiché la classe di base fornisce un'implementazione predefinita.
Passare l'istanza EncodingProvider al Encoding.RegisterProvider metodo per rendere disponibili le codifiche fornite dall'oggetto EncodingProvider a Common Language Runtime.
Chiamare un Encoding.GetEncoding overload per recuperare la codifica. Il Encoding.GetEncoding metodo chiamerà l'oggetto corrispondente EncodingProvider.GetEncoding per determinare se può fornire la codifica richiesta.
La libreria di classi .NET Framework fornisce una proprietà statica, CodePagesEncodingProvider.Instance, che restituisce un EncodingProvider oggetto che rende disponibile il set completo di codifiche 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
| Nome | Descrizione |
|---|---|
| EncodingProvider() |
Inizializza una nuova istanza della classe EncodingProvider. |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetEncoding(Int32, EncoderFallback, DecoderFallback) |
Restituisce la codifica associata all'identificatore della tabella codici specificato. I parametri specificano un gestore errori per i caratteri che non possono essere codificati e sequenze di byte che non possono essere decodificate. |
| GetEncoding(Int32) |
Restituisce la codifica associata all'identificatore della tabella codici 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 sequenze di byte che non possono essere decodificate. |
| GetEncoding(String) |
Restituisce la codifica con il nome specificato. |
| GetEncodings() |
Restituisce una matrice che contiene tutte le codifiche supportate da EncodingProvider. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
