EncodingProvider EncodingProvider EncodingProvider EncodingProvider Class

Definizione

Fornisce la classe base per un provider di codifica, che fornisce le codifiche non disponibili in una particolare piattaforma.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

public ref class EncodingProvider abstract
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Ereditarietà
EncodingProviderEncodingProviderEncodingProviderEncodingProvider
Derivato
Attributi

Commenti

Un provider di codifica fornisce le codifiche non disponibili in caso contrario, su una piattaforma di destinazione specifico.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

.NET Framework sul desktop di Windows supporta un numero elevato di caratteri codifiche e tabelle codici.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. È possibile ottenere un elenco completo delle codifiche disponibili in .NET Framework sul desktop di Windows tramite la chiamata di Encoding.GetEncodings (metodo).You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. .NET core, d'altra parte, per impostazione predefinita supporta solo le codifiche seguenti:.NET Core, on the other hand, by default supports only the following encodings:

A partire da .NET Framework 4.6, EncodingProvider è la classe base che in caso contrario, rende disponibili le codifiche disponibili in .NET Framework.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Ciò prevede i passaggi seguenti:This involves the following steps:

  1. Definire una sottoclasse di EncodingProvider che esegue l'override di due astratta GetEncoding overload GetEncoding(Int32) e GetEncoding(String).Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Questi overload restituiscono che l'in caso contrario, non è supportato dall'identificatore della tabella codici e in base al nome di codifica.These overloads return the otherwise unsupported encoding by code page identifier and by name. Si noti che è possibile anche scegliere di restituire un valore predefinito se la codifica di GetEncoding(Int32) viene chiamato con un argomento pari a 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. Facoltativamente, è possibile eseguire l'override virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) e GetEncoding(String, EncoderFallback, DecoderFallback) metodi.Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. Nella maggior parte dei casi, ciò non è necessario, poiché la classe di base fornisce un'implementazione predefinita.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Passare il EncodingProvider dell'istanza per il Encoding.RegisterProvider metodo per apportare le codifiche fornite dal EncodingProvider oggetto disponibile per 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. Chiamare un Encoding.GetEncoding overload per recuperare la codifica.Call an Encoding.GetEncoding overload to retrieve the encoding. Il Encoding.GetEncoding metodo verrà chiamata la corrispondente EncodingProvider.GetEncoding per determinare se è possibile fornire codifica richiesta.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

La libreria di classi .NET Framework fornisce una proprietà statica, CodePagesEncodingProvider.Instance, che restituisce un EncodingProvider oggetti che rende il set completo di codifiche disponibili nella libreria di classi Framework .NET desktop disponibili in .NET Core.NET Core applicazioni.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. Inoltre, è possibile derivare il EncodingProvider classe per rendere disponibile il proprio codifiche.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Costruttori

EncodingProvider() EncodingProvider() EncodingProvider() EncodingProvider()

Inizializza una nuova istanza della classe EncodingProvider.Initializes a new instance of the EncodingProvider class.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Restituisce la codifica associata all'identificatore della tabella codici specificata.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Restituisce la codifica associata all'identificatore della tabella codici specificata.Returns the encoding associated with the specified code page identifier. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Restituisce la codifica con il nome specificato.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Restituisce la codifica associata al nome specificato.Returns the encoding associated with the specified name. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche