EncodingProvider EncodingProvider EncodingProvider EncodingProvider Class

Definition

Stellt die Basisklasse für einen Codierungsanbieter bereit, der Codierungen liefert, die auf einer bestimmten Plattform nicht verfügbar sind.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

public ref class EncodingProvider abstract
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Vererbung
EncodingProviderEncodingProviderEncodingProviderEncodingProvider
Abgeleitet
Attribute

Hinweise

Ein Codierungs Anbieter liefert Codierungen, die anderweitig auf einer bestimmten Zielplattform nicht verfügbar sind.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

Die .NET Framework auf dem Windows-Desktop unterstützt eine große Anzahl von Zeichen Codierungen und Codepages.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. Sie können eine komplette Liste der Codierungen abrufen, die im .NET Framework auf dem Windows-Desktop verfügbar sind Encoding.GetEncodings , indem Sie die-Methode aufrufen.You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. .Net Core unterstützt dagegen standardmäßig nur die folgenden Codierungen:.NET Core, on the other hand, by default supports only the following encodings:

Beginnend mit dem .NET Framework 4,6 EncodingProvider ist die Basisklasse, die andernfalls nicht verfügbare Codierungen für die .NET Framework verfügbar macht.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Dies umfasst die folgenden Schritte:This involves the following steps:

  1. Definieren Sie eine Unterklasse EncodingProvider von, die die beiden abstrakten GetEncoding über Ladungen GetEncoding(Int32) und GetEncoding(String)überschreibt.Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Diese über Ladungen geben die ansonsten nicht unterstützte Codierung durch den Code Page Bezeichner und den Namen zurück.These overloads return the otherwise unsupported encoding by code page identifier and by name. Beachten Sie, dass Sie auch eine Standard Codierung zurückgeben können, GetEncoding(Int32) wenn die-Methode mit einem Argument von 0 aufgerufen wird.Note that you can also choose to return a default encoding if the GetEncoding(Int32) method is called with an argument of 0.

  2. Optional können Sie die virtuellen GetEncoding(Int32, EncoderFallback, DecoderFallback) Methoden und GetEncoding(String, EncoderFallback, DecoderFallback) überschreiben.Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. In den meisten Fällen ist dies nicht erforderlich, da die Basisklasse eine Standard Implementierung bereitstellt.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Übergeben Sie EncodingProvider die-Instanz Encoding.RegisterProvider an die-Methode, um die vom- EncodingProvider Objekt bereitgestellten Codierungen für die Common Language Runtime verfügbar zu machen.Pass the EncodingProvider instance to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.

  4. Rufen Sie Encoding.GetEncoding eine Überladung auf, um die Codierung abzurufen.Call an Encoding.GetEncoding overload to retrieve the encoding. Die Encoding.GetEncoding -Methode ruft die entsprechende EncodingProvider.GetEncoding auf, um zu bestimmen, ob Sie die angeforderte Codierung bereitstellen kann.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

Die .NET Framework-Klassenbibliothek stellt eine statische Eigenschaft CodePagesEncodingProvider.Instance,, bereit, EncodingProvider die ein Objekt zurückgibt, das den vollständigen Satz von Codierungen, die in der .NET Core.NET Core Desktop .NET Framework-Klassenbibliothek verfügbar sind, für Anwendungen verfügbar macht.The .NET Framework Class Library provides one static property, CodePagesEncodingProvider.Instance, that returns an EncodingProvider object that makes the full set of encodings available on the desktop .NET Framework Class Library available to .NET Core.NET Core applications. Darüber hinaus können Sie von der EncodingProvider -Klasse ableiten, um Ihre eigenen Codierungen verfügbar zu machen.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Konstruktoren

EncodingProvider() EncodingProvider() EncodingProvider() EncodingProvider()

Initialisiert eine neue Instanz der EncodingProvider-Klasse.Initializes a new instance of the EncodingProvider class.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.Returns the encoding associated with the specified code page identifier. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Gibt die Codierung mit dem angegebenen Namen zurück.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Gibt die dem angegebenen Namen zugeordnete Codierung zurück.Returns the encoding associated with the specified name. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch