EncodingProvider.GetEncoding Metodo

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

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

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

• GetEncoding(Int32)

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

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

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

• GetEncoding(String)

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

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

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:

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

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

Origine:

EncodingProvider.cs

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

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:

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