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

Definición

Registra un proveedor de codificación.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)

Parámetros

provider
EncodingProvider EncodingProvider EncodingProvider EncodingProvider

Subclase de EncodingProvider que proporciona acceso a codificaciones de caracteres adicionales.A subclass of EncodingProvider that provides access to additional character encodings.

Excepciones

Comentarios

El RegisterProvider método le permite registrar una clase derivada de EncodingProvider que hace carácter codificaciones disponibles en una plataforma que no los admite en caso contrario.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. Una vez registrado el proveedor de codificación, se pueden recuperar las codificaciones que admite mediante una llamada a cualquier Encoding.GetEncoding sobrecargar.Once the encoding provider is registered, the encodings that it supports can be retrieved by calling any Encoding.GetEncoding overload. Si hay varios proveedores de codificación, el Encoding.GetEncoding método intenta recuperar una codificación especificada de cada proveedor empezando por la que se registró más recientemente.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.

Registrar un proveedor de codificación mediante la RegisterProvider método también modifica el comportamiento de la Encoding.GetEncoding (Int32) y EncodingProvider.GetEncoding (Int32, EncoderFallback, DecoderFallback ) métodos cuando se pasa un argumento de 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:

  • Si el proveedor registrado es el CodePagesEncodingProvider, el método devuelve la codificación que coincida con la página de códigos activa del sistema cuando se ejecuta en el 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 proveedor de codificación personalizado puede elegir qué codificación se debe devolver cuando cualquiera de estos GetEncoding sobrecargas del método se pasa un argumento de 0.A custom encoding provider can choose which encoding to return when either of these GetEncoding method overloads is passed an argument of 0. El proveedor también puede optar por no devolver una codificación al tener el EncodingProvider.GetEncoding devuelto del método null.The provider can also choose to not return an encoding by having the EncodingProvider.GetEncoding method return null.

A partir de la versión 4.6 de .NET Framework, .NET Framework incluye un proveedor de codificación y CodePagesEncodingProvider, que hace que las codificaciones disponibles que están presentes en la versión completa de .NET Framework pero que no están disponibles en la plataforma Universal de Windows.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. De forma predeterminada, la plataforma Universal de Windows solo admite las codificaciones Unicode, ASCII y la página de códigos 28591.By default, the Universal Windows Platform only supports the Unicode encodings, ASCII, and code page 28591.

Si se usa el mismo proveedor de codificación en varias llamadas a la RegisterProvider método, solo la primera llamada al método registra el proveedor.If the same encoding provider is used in multiple calls to the RegisterProvider method, only the first method call registers the provider. Se omiten las llamadas subsiguientes.Subsequent calls are ignored.

Si el RegisterProvider método se invoca para registrar varios proveedores que administran la misma codificación, el último proveedor registrado es el utilizado para codificar todos y las operaciones de descodificación.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. Se omiten todos los proveedores registrados anteriormente.Any previously registered providers are ignored.

Se aplica a

Consulte también: