EncodingProvider.GetEncoding Methode

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

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

Parameter

Gibt zurück

Die der angegebenen Codepage zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die codepage entspricht.

Hinweise

Notizen für Anrufer

Diese Methode wird von der Encoding.GetEncoding(Int32) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(Int32) -Methode, um die von Ihrer EncodingProvider Unterklasse unterstützte Codierung oder Codierung zurückzugeben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(Int32) -Methode abzurufen, übergibt die -Methode den codepage Bezeichner an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepagebezeichner ist codepage. Aus diesem Grund sollte nulldie Methode zurückgeben, wenn codepage es sich nicht um den Codepage-Bezeichner einer von Ihnen unterstützten Codierung handelt. Sie sollte niemals eine Ausnahme auslösen.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(Int32)

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

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

Parameter

Gibt zurück

Die dem angegebenen Namen zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die name entspricht.

Hinweise

Hinweise zu Erben

Sie überschreiben die GetEncoding(String)- Methode, um die von Ihrer EncodingProvider Unterklasse unterstützte Codierung oder Codierung zurückzugeben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String)- Methode abzurufen, übergibt die -Methode das name Argument an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(String)- Methode, eine zwischengespeicherte Codierung abzurufen, deren Name lautet name. Aus diesem Grund sollte die -Methode zurückgeben, wenn name nicht der Name einer von Ihnen unterstützten Codierung ist null. Der einzige Fall, in dem die -Methode eine Ausnahme auslösen sollte, ist , wenn name ist null.

Notizen für Anrufer

Diese Methode wird von der Encoding.GetEncoding(String)- Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(String) -Methode, um die von Ihrer EncodingProvider Unterklasse unterstützte Codierung oder Codierung zurückzugeben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String) -Methode abzurufen, übergibt die -Methode das name Argument an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(String) -Methode, eine zwischengespeicherte Codierung abzurufen, deren Name lautet name. Aus diesem Grund sollte die -Methode zurückgeben, wenn name nicht der Name einer von Ihnen unterstützten Codierung ist null. Der einzige Fall, in dem die -Methode eine Ausnahme auslösen sollte, ist , wenn name ist null.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(String)

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

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

Parameter

Gibt zurück

Die der angegebenen Codepage zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die codepage entspricht.

Hinweise

Die encoderFallback Parameter und decoderFallback sind Objekte, die die Fallbackstrategie definieren, die für den Fall verwendet wird, dass ein Encoder ein Zeichen nicht in eine Bytesequenz konvertieren kann oder ein Decoder eine Bytesequenz nicht in ein Zeichen konvertieren kann. Die .NET Framework bietet die folgenden Fallbackmechanismen:

• Ausnahmefallback. Wenn das encoderFallback Argument ein instance von EncoderExceptionFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderExceptionFallbackist, löst die Codierungsmethode eine Ausnahme aus, wenn Zeichen nicht codiert werden können, und die Decodierungsmethode löst eine Ausnahme aus, wenn eine Bytesequenz nicht decodiert werden kann.

• Ersatzfallback. Wenn das encoderFallback Argument ein instance von EncoderReplacementFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderReplacementFallbackist, ersetzen die Codierungs- und Decodierungsmethoden eine Ersatzzeichenfolge für Zeichen, die nicht codiert werden können, und Bytesequenzen können nicht decodiert werden. Wenn Sie das Ersatzfallbackobjekt instanziiert haben, indem Sie den parameterlosen Konstruktor aufrufen, ist das Ersatzzeichen ein "?". Wenn Sie den EncoderReplacementFallback.EncoderReplacementFallback(String) Konstruktor oder DecoderReplacementFallback.DecoderReplacementFallback(String) aufrufen, können Sie die Ersatzzeichenfolge angeben.

• Am besten geeignetes Fallback. Sie können von der EncoderFallback -Klasse oder DecoderFallback ableiten, um einen am besten geeigneten Ersatzmechanismus zu implementieren.

Hinweise für Vererber

Da Aufrufe dieser Methode Ihre Implementierung der GetEncoding(Int32) Methode verwenden, müssen Sie sie nicht überschreiben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode abzurufen, übergibt die -Methode den codepage Bezeichner an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepagebezeichner ist codepage. Aus diesem Grund sollte die Überschreibung der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode zurückgegeben null werden, wenn codepage nicht der Codepage-Bezeichner einer von Ihnen unterstützten Codierung ist. Es sollte niemals eine Ausnahme ausgelöst werden.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

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

Parameter

Gibt zurück

Die dem angegebenen Namen zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die name entspricht.

Hinweise

Die encoderFallback Parameter und decoderFallback sind Objekte, die die Fallbackstrategie definieren, die für den Fall verwendet wird, dass ein Encoder ein Zeichen nicht in eine Bytesequenz konvertieren kann oder ein Decoder eine Bytesequenz nicht in ein Zeichen konvertieren kann. Die .NET Framework bietet die folgenden Fallbackmechanismen:

• Ausnahmefallback. Wenn das encoderFallback Argument ein instance von EncoderExceptionFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderExceptionFallbackist, löst die Codierungsmethode eine Ausnahme aus, wenn Zeichen nicht codiert werden können, und die Decodierungsmethode löst eine Ausnahme aus, wenn eine Bytesequenz nicht decodiert werden kann.

• Ersatzfallback. Wenn das encoderFallback Argument ein instance von EncoderReplacementFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderReplacementFallbackist, ersetzen die Codierungs- und Decodierungsmethoden eine Ersatzzeichenfolge für Zeichen, die nicht codiert werden können, und Bytesequenzen können nicht decodiert werden. Wenn Sie das Ersatzfallbackobjekt instanziiert haben, indem Sie den parameterlosen Konstruktor aufrufen, ist das Ersatzzeichen ein "?". Wenn Sie den EncoderReplacementFallback.EncoderReplacementFallback(String) Konstruktor oder DecoderReplacementFallback.DecoderReplacementFallback(String) aufrufen, können Sie die Ersatzzeichenfolge angeben.

• Am besten geeignetes Fallback. Sie können von der EncoderFallback -Klasse oder DecoderFallback ableiten, um einen am besten geeigneten Ersatzmechanismus zu implementieren.

Hinweise für Vererber

Da Aufrufe dieser Methode Ihre Implementierung der GetEncoding(String) Methode verwenden, müssen Sie sie nicht überschreiben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String, EncoderFallback, DecoderFallback) -Methode abzurufen, übergibt die -Methode den codepage Bezeichner an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepagebezeichner ist codepage. Aus diesem Grund sollte die Überschreibung der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode zurückgegeben null werden, wenn codepage nicht der Codepage-Bezeichner einer von Ihnen unterstützten Codierung ist. Es sollte niemals eine Ausnahme ausgelöst werden.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String, EncoderFallback, DecoderFallback) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(String, EncoderFallback, DecoderFallback)