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
public abstract class EncodingProvider
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Inheritance
EncodingProvider
Derived
Attributes

Remarks

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. Eine komplette Liste der Codierungen, die im .NET Framework auf dem Windows-Desktop verfügbar sind, erhalten Sie, indem Sie die Encoding.GetEncodings-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 ist EncodingProvider 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. Dieser Vorgang umfasst die folgenden Schritte:This involves the following steps:

  1. Definieren Sie eine Unterklasse von EncodingProvider, die die beiden abstrakten GetEncoding Überladungen, 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, wenn die GetEncoding(Int32)-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 Methoden des virtuellen GetEncoding(Int32, EncoderFallback, DecoderFallback) 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 die EncodingProvider-Instanz an die Encoding.RegisterProvider-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 eine Encoding.GetEncoding Ü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, die ein EncodingProvider Objekt zurückgibt, das den vollständigen Satz von Codierungen, die auf der Desktop .NET Framework-Klassenbibliothek verfügbar sind, für .NET Core.NET Core 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. Außerdem 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.

Constructors

EncodingProvider()

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

Methods

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)

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

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)

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

GetEncoding(String, EncoderFallback, DecoderFallback)

Gibt die Codierung mit dem angegebenen Namen 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()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType()

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

(Inherited from Object)
MemberwiseClone()

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

(Inherited from Object)
ToString()

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

(Inherited from Object)

Applies to

See also