EncodingProvider.GetEncoding Metodo

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

Valori restituiti

Codifica associata alla tabella codici specificata o null se non EncodingProvider può restituire una codifica valida corrispondente a codepage.

Commenti

Note per i chiamanti

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

Note per gli implementatori

Eseguire l'override del GetEncoding(Int32) metodo per restituire la codifica o le codifiche supportate dalla EncodingProvider sottoclasse. Quando il codice utente tenta di recuperare una codifica chiamando il GetEncoding(Int32) metodo , il metodo passa l'identificatore 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. Per questo motivo, se codepage non è l'identificatore della tabella codici di una codifica supportata, il metodo deve restituire null. Non deve mai generare un'eccezione.

Note per i chiamanti

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

Vedi anche

• GetEncoding(Int32)

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

Valori restituiti

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

Commenti

Note per gli eredi

Eseguire l'override del metodo GetEncoding(String) per restituire la codifica o le codifiche 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. Per questo motivo, 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 chiamarlo direttamente dal codice utente.

Note per gli implementatori

Eseguire l'override del GetEncoding(String) metodo per restituire la codifica o le codifiche supportate dalla EncodingProvider sottoclasse. Quando il codice utente tenta di recuperare una codifica chiamando il GetEncoding(String) metodo , 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 GetEncoding(String) metodo tenta di recuperare una codifica memorizzata nella cache il cui nome è name. Per questo motivo, 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 chiamarlo direttamente dal codice utente.

Vedi anche

• GetEncoding(String)

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

Valori restituiti

Codifica associata alla tabella codici specificata o null se non EncodingProvider può restituire una codifica valida corrispondente 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 meccanismi di fallback seguenti:

• Fallback delle eccezioni. Se l'argomento è un'istanza encoderFallback di EncoderExceptionFallbacko l'argomento è un'istanza decoderExceptionFallback di , il metodo di DecoderExceptionFallbackcodifica 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 encoderFallback di EncoderReplacementFallbacko l'argomento è un'istanza decoderExceptionFallback di , i metodi di DecoderReplacementFallbackcodifica e decodifica sostituiscono una stringa di sostituzione per i caratteri che non possono essere codificati e le sequenze di byte non possono essere decodificate. Se è stata creata un'istanza dell'oggetto di fallback di sostituzione 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 più adatto.

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 GetEncoding(Int32, EncoderFallback, DecoderFallback) metodo , il metodo passa l'identificatore 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. Per questo motivo, 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 deve mai generare un'eccezione.

Note per i chiamanti

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

Vedi anche

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

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

Valori restituiti

Codifica associata al nome specificato o null se non EncodingProvider 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 fornisce i meccanismi di fallback seguenti:

• Fallback delle eccezioni. Se l'argomento è un'istanza encoderFallback di EncoderExceptionFallbacko l'argomento è un'istanza decoderExceptionFallback di , il metodo di DecoderExceptionFallbackcodifica 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 encoderFallback di EncoderReplacementFallbacko l'argomento è un'istanza decoderExceptionFallback di , i metodi di DecoderReplacementFallbackcodifica e decodifica sostituiscono una stringa di sostituzione per i caratteri che non possono essere codificati e le sequenze di byte non possono essere decodificate. Se è stata creata un'istanza dell'oggetto di fallback di sostituzione 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 più adatto.

Note per i chiamanti

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

Vedi anche

• GetEncoding(String, EncoderFallback, DecoderFallback)