Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Method

Definizione

Registra un provider di codifica.Registers an encoding provider.

public:
 static void RegisterProvider(System::Text::EncodingProvider ^ provider);
[System.Security.SecurityCritical]
public static void RegisterProvider (System.Text.EncodingProvider provider);
static member RegisterProvider : System.Text.EncodingProvider -> unit
Public Shared Sub RegisterProvider (provider As EncodingProvider)

Parametri

provider
EncodingProvider EncodingProvider EncodingProvider EncodingProvider

Sottoclasse di EncodingProvider che fornisce l'accesso a codifiche caratteri aggiuntive.A subclass of EncodingProvider that provides access to additional character encodings.

Eccezioni

Commenti

Il RegisterProvider metodo consente di registrare una classe derivata da EncodingProvider che rende carattere le codifiche disponibili in una piattaforma che non in caso contrario, li supporta.The RegisterProvider method allows you to register a class derived from EncodingProvider that makes character encodings available on a platform that does not otherwise support them. Dopo aver registrato il provider di codifica, le codifiche supportate possono essere recuperate chiamando qualsiasi Encoding.GetEncoding rapporto di overload.Once the encoding provider is registered, the encodings that it supports can be retrieved by calling any Encoding.GetEncoding overload. Se sono presenti più provider di codifica, la Encoding.GetEncoding metodo tenta di recuperare una codifica specificata da ogni provider a partire da quello registrato più di recente.If there are multiple encoding providers, the Encoding.GetEncoding method attempts to retrieve a specified encoding from each provider starting with the one most recently registered.

Registrazione di un provider di codifica utilizzando il RegisterProvider metodo modifica anche il comportamento del Encoding.GetEncoding(Int32) e EncodingProvider.GetEncoding (Int32, EncoderFallback, DecoderFallback ) metodi quando viene passato un argomento di 0:Registering an encoding provider by using the RegisterProvider method also modifies the behavior of the Encoding.GetEncoding(Int32) and EncodingProvider.GetEncoding(Int32, EncoderFallback, DecoderFallback) methods when passed an argument of 0:

  • Se il provider registrato è il CodePagesEncodingProvider, il metodo restituisce il tipo di codifica che corrisponde alla tabella codici attiva di sistema durante l'esecuzione nel sistema operativo Windows.If the registered provider is the CodePagesEncodingProvider, the method returns the encoding that matches the system active code page when running on the Windows operating system.

  • Un provider di codifica personalizzato è possibile scegliere la codifica da restituire quando uno di questi GetEncoding overload del metodo è stato passato un argomento di 0.A custom encoding provider can choose which encoding to return when either of these GetEncoding method overloads is passed an argument of 0. Il provider può anche scegliere di non restituire una codifica facendo in modo che il EncodingProvider.GetEncoding metodo viene restituito null.The provider can also choose to not return an encoding by having the EncodingProvider.GetEncoding method return null.

A partire da .NET Framework 4.6, .NET Framework include un provider di codifica, CodePagesEncodingProvider, che rende disponibili le codifiche sono presenti in .NET Framework completo, ma non sono disponibili nella piattaforma Windows universale.Starting with the .NET Framework 4.6, the .NET Framework includes one encoding provider, CodePagesEncodingProvider, that makes the encodings available that are present in the full .NET Framework but are not available in the Universal Windows Platform. Per impostazione predefinita, la piattaforma universale di Windows supporta solo le codifiche Unicode, ASCII e tabella codici 28591.By default, the Universal Windows Platform only supports the Unicode encodings, ASCII, and code page 28591.

Se viene utilizzato lo stesso provider di codifica in più chiamate al RegisterProvider (metodo), solo la prima chiamata al metodo registra il provider.If the same encoding provider is used in multiple calls to the RegisterProvider method, only the first method call registers the provider. Le chiamate successive vengono ignorate.Subsequent calls are ignored.

Se il RegisterProvider viene chiamato per registrare più provider che gestiscono la stessa codifica, l'ultimo provider registrato è l'oggetto utilizzato per tutte le operazioni di operazioni di decodifica e codifica.If the RegisterProvider method is called to register multiple providers that handle the same encoding, the last registered provider is the used for all encoding and decoding operations. Tutti i provider registrati in precedenza vengono ignorati.Any previously registered providers are ignored.

Si applica a

Vedi anche