EncodingProvider.GetEncoding Metodo

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Runtime.dll

Restituisce una codifica.

Overload

GetEncoding(Int32)	Restituisce la codifica associata all'identificatore della tabella codici specificata.
GetEncoding(String)	Restituisce la codifica con il nome specificato.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Restituisce la codifica associata all'identificatore della tabella codici specificata. 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.
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 per le sequenze di byte che non possono essere decodificate.

GetEncoding(Int32)

Origine:

EncodingProvider.cs

Restituisce la codifica associata all'identificatore della tabella codici specificata.

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

Parametri

codepage

Int32

Identificatore della tabella codici della codifica richiesta.

Restituisce

Encoding

Codifica associata alla tabella codici specificata oppure null se questo oggetto EncodingProvider non è in grado di restituire una codifica valida che corrisponde a codepage.

Commenti

Note per i chiamanti

Questo metodo viene chiamato dal metodo Encoding.GetEncoding(Int32). Non è consigliabile chiamarla direttamente dal codice utente.

Note per gli implementatori

Eseguire l'override del GetEncoding(Int32) metodo per restituire la codifica o le codifica supportate dalla EncodingProvider sottoclasse. Quando il codice utente tenta di recuperare una codifica chiamando il metodo, il metodo passa l'identificatore GetEncoding(Int32)codepage a ogni provider di codifica registrato fino a quando non restituisce una codifica valida. Se nessuno restituisce una codifica valida, il GetEncoding(Int32) metodo tenta di recuperare una codifica memorizzata nella cache il cui identificatore della tabella codici è codepage. A causa di questo, se codepage non è l'identificatore della tabella codici di una codifica supportata, il metodo deve restituire null; non dovrebbe mai generare un'eccezione.

Note per i chiamanti

Questo metodo viene chiamato dal GetEncoding(Int32) metodo . Non è consigliabile chiamarla direttamente dal codice utente.

Vedi anche

• GetEncoding(Int32)

GetEncoding(String)

Origine:

EncodingProvider.cs

Restituisce la codifica con il nome specificato.

public:
 abstract System::Text::Encoding ^ GetEncoding(System::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

Parametri

name

String

Nome della codifica richiesta.

Restituisce

Encoding

Codifica associata al nome specificato oppure null se questo oggetto EncodingProvider non può restituire una codifica valida che corrisponde a name.

Commenti

Note da ereditare

Si esegue l'override del metodo GetEncoding(String) per restituire la codifica o le codifica supportate dalla EncodingProvider sottoclasse. Quando il codice utente tenta di recuperare una codifica chiamando il metodo GetEncoding(String), il metodo passa l'argomento name a ogni provider di codifica registrato fino a quando non restituisce una codifica valida. Se nessuno restituisce una codifica valida, il metodo GetEncoding(String) tenta di recuperare una codifica memorizzata nella cache il cui nome è name. A causa di questo, se name non è il nome di una codifica supportata, il metodo deve restituire null. L'unico caso in cui il metodo deve generare un'eccezione è se name è null.

Note per i chiamanti

Questo metodo viene chiamato dal metodo Encoding.GetEncoding(String). Non è consigliabile chiamarla direttamente dal codice utente.

Note per gli implementatori

Eseguire l'override del GetEncoding(String) metodo per restituire la codifica o le codifica supportate dalla EncodingProvider sottoclasse. Quando il codice utente tenta di recuperare una codifica chiamando il metodo, il metodo passa l'argomento GetEncoding(String)name a ogni provider di codifica registrato finché non restituisce una codifica valida. Se nessuno restituisce una codifica valida, il GetEncoding(String) metodo tenta di recuperare una codifica memorizzata nella cache il cui nome è name. A causa di questo, se name non è il nome di una codifica supportata, il metodo deve restituire null. L'unico caso in cui il metodo deve generare un'eccezione è se name è null.

Note per i chiamanti

Questo metodo viene chiamato dal GetEncoding(String) metodo . Non è consigliabile chiamarla direttamente dal codice utente.

Vedi anche

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Origine:

EncodingProvider.cs

Restituisce la codifica associata all'identificatore della tabella codici specificata. 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.

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

Parametri

codepage

Int32

Identificatore della tabella codici della codifica richiesta.

encoderFallback

EncoderFallback

Oggetto che offre una procedura di gestione degli errori quando un carattere non può essere codificato con questa codifica.

decoderFallback

DecoderFallback

Oggetto che offre una procedura di gestione degli errori quando una sequenza di byte non può essere decodificata con questa codifica.

Restituisce

Encoding

Codifica associata alla tabella codici specificata oppure null se questo oggetto EncodingProvider non è in grado di restituire una codifica valida che corrisponde a codepage.

Commenti

I encoderFallback parametri e decoderFallback sono oggetti che definiscono la strategia di fallback utilizzata nel caso in cui un codificatore non possa convertire un carattere in una sequenza di byte o un decodificatore non può convertire una sequenza di byte in un carattere. .NET Framework fornisce i seguenti meccanismi di fallback:

• Fallback delle eccezioni. Se l'argomento è un'istanza di o l'argomento encoderFallbackdecoderExceptionFallback è un'istanza di EncoderExceptionFallbackDecoderExceptionFallback, il metodo di codifica genera un'eccezione se i caratteri non possono essere codificati e il metodo di decodifica genera un'eccezione se non è possibile decodificare una sequenza di byte.

• Fallback di sostituzione. Se l'argomento è un'istanza di o l'argomento encoderFallback è un'istanza decoderExceptionFallback di EncoderReplacementFallbackDecoderReplacementFallback, i metodi di codifica e decodifica sostituiscono una stringa sostitutiva per i caratteri che non possono essere codificati e sequenze di byte non possono essere decodificati. Se si crea un'istanza dell'oggetto di fallback sostitutivo chiamando il costruttore senza parametri, il carattere di sostituzione è "?". Se si chiama il EncoderReplacementFallback.EncoderReplacementFallback(String) costruttore o DecoderReplacementFallback.DecoderReplacementFallback(String) , è possibile specificare la stringa di sostituzione.

• Fallback più adatto. È possibile derivare dalla EncoderFallback classe o DecoderFallback per implementare un meccanismo di sostituzione ottimale.

Note per gli eredi

Poiché le chiamate a questo metodo usano l'implementazione del GetEncoding(Int32) metodo, non è necessario eseguirne l'override. Quando il codice utente tenta di recuperare una codifica chiamando il metodo, il metodo passa l'identificatore GetEncoding(Int32, EncoderFallback, DecoderFallback)codepage a ogni provider di codifica registrato fino a quando non restituisce una codifica valida. Se nessuno restituisce una codifica valida, il GetEncoding(Int32) metodo tenta di recuperare una codifica memorizzata nella cache il cui identificatore della tabella codici è codepage. A causa di questo, se si sceglie di eseguire l'override del GetEncoding(Int32, EncoderFallback, DecoderFallback) metodo, l'override deve restituire null se codepage non è l'identificatore della tabella codici di una codifica supportata. Non dovrebbe mai generare un'eccezione.

Note per i chiamanti

Questo metodo viene chiamato dal GetEncoding(Int32, EncoderFallback, DecoderFallback) metodo . Non è consigliabile chiamarla direttamente dal codice utente.

Vedi anche

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Origine:

EncodingProvider.cs

Restituisce la codifica associata al nome specificato. 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.

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);

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

Parametri

name

String

Nome della codifica preferita.

encoderFallback

EncoderFallback

Oggetto che offre una procedura di gestione degli errori quando un carattere non può essere codificato con questa codifica.

decoderFallback

DecoderFallback

Oggetto che fornisce una procedura di gestione degli errori quando una sequenza di byte non può essere decodificata con la codifica corrente.

Restituisce

Encoding

Codifica associata al nome specificato oppure null se questo oggetto EncodingProvider non può restituire una codifica valida che corrisponde a name.

Commenti

I encoderFallback parametri e decoderFallback sono oggetti che definiscono la strategia di fallback utilizzata nel caso in cui un codificatore non possa convertire un carattere in una sequenza di byte o un decodificatore non può convertire una sequenza di byte in un carattere. .NET Framework fornisce i seguenti meccanismi di fallback:

• Fallback delle eccezioni. Se l'argomento è un'istanza di o l'argomento encoderFallbackdecoderExceptionFallback è un'istanza di EncoderExceptionFallbackDecoderExceptionFallback, il metodo di codifica genera un'eccezione se i caratteri non possono essere codificati e il metodo di decodifica genera un'eccezione se non è possibile decodificare una sequenza di byte.

• Fallback di sostituzione. Se l'argomento è un'istanza di o l'argomento encoderFallback è un'istanza decoderExceptionFallback di EncoderReplacementFallbackDecoderReplacementFallback, i metodi di codifica e decodifica sostituiscono una stringa sostitutiva per i caratteri che non possono essere codificati e sequenze di byte non possono essere decodificati. Se si crea un'istanza dell'oggetto di fallback sostitutivo chiamando il costruttore senza parametri, il carattere di sostituzione è "?". Se si chiama il EncoderReplacementFallback.EncoderReplacementFallback(String) costruttore o DecoderReplacementFallback.DecoderReplacementFallback(String) , è possibile specificare la stringa di sostituzione.

• Fallback più adatto. È possibile derivare dalla EncoderFallback classe o DecoderFallback per implementare un meccanismo di sostituzione ottimale.

Note per gli eredi

Poiché le chiamate a questo metodo usano l'implementazione del GetEncoding(String) metodo, non è necessario eseguirne l'override. Quando il codice utente tenta di recuperare una codifica chiamando il metodo, il metodo passa l'identificatore GetEncoding(String, EncoderFallback, DecoderFallback)codepage a ogni provider di codifica registrato fino a quando non restituisce una codifica valida. Se nessuno restituisce una codifica valida, il GetEncoding(Int32) metodo tenta di recuperare una codifica memorizzata nella cache il cui identificatore della tabella codici è codepage. A causa di questo, se si sceglie di eseguire l'override del GetEncoding(Int32, EncoderFallback, DecoderFallback) metodo, l'override deve restituire null se codepage non è l'identificatore della tabella codici di una codifica supportata. Non dovrebbe mai generare un'eccezione.

Note per i chiamanti

Questo metodo viene chiamato dal GetEncoding(String, EncoderFallback, DecoderFallback) metodo . Non è consigliabile chiamarla direttamente dal codice utente.

Vedi anche

• GetEncoding(String, EncoderFallback, DecoderFallback)