Compartir a través de


EncodingProvider.GetEncoding Método

Definición

Devuelve una codificación.

Sobrecargas

GetEncoding(Int32)

Devuelve la codificación asociada al identificador de página de códigos especificado.

GetEncoding(String)

Devuelve la codificación con el nombre especificado.

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada al identificador de página de códigos especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.

GetEncoding(String, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada con el nombre especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.

GetEncoding(Int32)

Source:
EncodingProvider.cs
Source:
EncodingProvider.cs
Source:
EncodingProvider.cs

Devuelve la codificación asociada al identificador de página de códigos especificado.

public:
 abstract System::Text::Encoding ^ GetEncoding(int codepage);
public abstract System.Text.Encoding GetEncoding (int codepage);
public abstract System.Text.Encoding? GetEncoding (int codepage);
abstract member GetEncoding : int -> System.Text.Encoding
Public MustOverride Function GetEncoding (codepage As Integer) As Encoding

Parámetros

codepage
Int32

Identificador de página de códigos de la codificación solicitada.

Devoluciones

Codificación asociada a la página de códigos especificada, o null si EncodingProvider no puede devolver una codificación válida que corresponda a codepage.

Comentarios

Notas a los autores de llamadas

El método Encoding.GetEncoding(Int32) llama a este método. No debe llamarlo directamente desde el código de usuario.

Notas a los implementadores

Invalida el GetEncoding(Int32) método para devolver la codificación o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al GetEncoding(Int32) método , el método pasa el codepage identificador a cada proveedor de codificación registrado hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(Int32) método intenta recuperar una codificación almacenada en caché cuyo identificador de página de códigos es codepage. Por este motivo, si codepage no es el identificador de página de códigos de una codificación que admita, el método debe devolver null; nunca debería producir una excepción.

Notas a los autores de las llamadas

El método llama a GetEncoding(Int32) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

Se aplica a

GetEncoding(String)

Source:
EncodingProvider.cs
Source:
EncodingProvider.cs
Source:
EncodingProvider.cs

Devuelve la codificación con el nombre especificado.

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);
public abstract System.Text.Encoding GetEncoding (string name);
public abstract System.Text.Encoding? GetEncoding (string name);
abstract member GetEncoding : string -> System.Text.Encoding
Public MustOverride Function GetEncoding (name As String) As Encoding

Parámetros

name
String

Nombre de la codificación solicitada.

Devoluciones

Codificación asociada al nombre especificado, o EncodingProvider si null no puede devolver una codificación válida que corresponda a name.

Comentarios

Notas a los heredadores

Invalida el método GetEncoding(String) para devolver la codificación o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al método GetEncoding(String), el método pasa el name argumento a cada proveedor de codificación registrado hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el método GetEncoding(String) intenta recuperar una codificación almacenada en caché cuyo nombre es name. Por este motivo, si name no es el nombre de una codificación que admita, el método debe devolver null. El único caso en el que el método debe producir una excepción es si name es null.

Notas a los autores de llamadas

El método Encoding.GetEncoding(String) llama a este método. No debe llamarlo directamente desde el código de usuario.

Notas a los implementadores

Invalida el GetEncoding(String) método para devolver la codificación o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al GetEncoding(String) método , el método pasa el name argumento a cada proveedor de codificación registrado hasta que uno devuelva una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(String) método intenta recuperar una codificación almacenada en caché cuyo nombre es name. Por este motivo, si name no es el nombre de una codificación que admita, el método debe devolver null. El único caso en el que el método debe producir una excepción es si name es null.

Notas a los autores de las llamadas

El método llama a GetEncoding(String) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

Se aplica a

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Source:
EncodingProvider.cs
Source:
EncodingProvider.cs
Source:
EncodingProvider.cs

Devuelve la codificación asociada al identificador de página de códigos especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.

public:
 virtual System::Text::Encoding ^ GetEncoding(int codepage, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);
public virtual System.Text.Encoding GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
public virtual System.Text.Encoding? GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
abstract member GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
Public Overridable Function GetEncoding (codepage As Integer, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parámetros

codepage
Int32

Identificador de página de códigos de la codificación solicitada.

encoderFallback
EncoderFallback

Objeto que proporciona un procedimiento de control de errores cuando no se puede codificar un carácter con esta codificación.

decoderFallback
DecoderFallback

Objeto que proporciona un procedimiento de control de errores cuando una secuencia de bytes no se puede descodificar con esta codificación.

Devoluciones

Codificación asociada a la página de códigos especificada, o null si EncodingProvider no puede devolver una codificación válida que corresponda a codepage.

Comentarios

Los encoderFallback parámetros y decoderFallback son objetos que definen la estrategia de reserva utilizada en el caso de que un codificador no pueda convertir un carácter en una secuencia de bytes o un descodificador no puede convertir una secuencia de bytes en un carácter. .NET Framework proporciona los siguientes mecanismos de reserva:

Notas a los desarrolladores de herederos

Dado que las llamadas a este método usan la GetEncoding(Int32) implementación del método , no es necesario invalidarlo. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al GetEncoding(Int32, EncoderFallback, DecoderFallback) método , el método pasa el codepage identificador a cada proveedor de codificación registrado hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(Int32) método intenta recuperar una codificación almacenada en caché cuyo identificador de página de códigos es codepage. Por este motivo, si decide invalidar el GetEncoding(Int32, EncoderFallback, DecoderFallback) método , la invalidación debe devolver null si codepage no es el identificador de página de códigos de una codificación que admita; nunca debería producir una excepción.

Notas a los autores de las llamadas

El método llama a GetEncoding(Int32, EncoderFallback, DecoderFallback) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

Se aplica a

GetEncoding(String, EncoderFallback, DecoderFallback)

Source:
EncodingProvider.cs
Source:
EncodingProvider.cs
Source:
EncodingProvider.cs

Devuelve la codificación asociada con el nombre especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.

public:
 virtual System::Text::Encoding ^ GetEncoding(System::String ^ name, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);
public virtual System.Text.Encoding GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
public virtual System.Text.Encoding? GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
abstract member GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
Public Overridable Function GetEncoding (name As String, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parámetros

name
String

Nombre de la codificación preferida.

encoderFallback
EncoderFallback

Objeto que proporciona un procedimiento de control de errores cuando no se puede codificar un carácter con esta codificación.

decoderFallback
DecoderFallback

Objeto que proporciona un procedimiento de control de errores cuando una secuencia de bytes no se puede descodificar con la codificación actual.

Devoluciones

Codificación asociada al nombre especificado, o EncodingProvider si null no puede devolver una codificación válida que corresponda a name.

Comentarios

Los encoderFallback parámetros y decoderFallback son objetos que definen la estrategia de reserva utilizada en el caso de que un codificador no pueda convertir un carácter en una secuencia de bytes o un descodificador no puede convertir una secuencia de bytes en un carácter. .NET Framework proporciona los siguientes mecanismos de reserva:

Notas a los desarrolladores de herederos

Dado que las llamadas a este método usan la GetEncoding(String) implementación del método , no es necesario invalidarlo. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al GetEncoding(String, EncoderFallback, DecoderFallback) método , el método pasa el codepage identificador a cada proveedor de codificación registrado hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(Int32) método intenta recuperar una codificación almacenada en caché cuyo identificador de página de códigos es codepage. Por este motivo, si decide invalidar el GetEncoding(Int32, EncoderFallback, DecoderFallback) método , la invalidación debe devolver null si codepage no es el identificador de página de códigos de una codificación que admita; nunca debería producir una excepción.

Notas a los autores de las llamadas

El método llama a GetEncoding(String, EncoderFallback, DecoderFallback) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

Se aplica a