EncodingProvider Klasse

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
EncodingProvider
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. 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. Dies 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.

Konstruktoren

EncodingProvider()

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

Methoden

Equals(Object)

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

(Geerbt von 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()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Gilt für:

Siehe auch