Condividi tramite


EncodingProvider.GetEncoding Metodo

Definizione

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
Origine:
EncodingProvider.cs
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);
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

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

Si applica a

GetEncoding(String)

Origine:
EncodingProvider.cs
Origine:
EncodingProvider.cs
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);
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

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

Si applica a

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Origine:
EncodingProvider.cs
Origine:
EncodingProvider.cs
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);
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

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:

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

Si applica a

GetEncoding(String, EncoderFallback, DecoderFallback)

Origine:
EncodingProvider.cs
Origine:
EncodingProvider.cs
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);
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

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:

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

Si applica a