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
public abstract class EncodingProvider
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
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. Sie können eine komplette Liste der Codierungen abrufen, die im .NET Framework auf dem Windows-Desktop verfügbar sind, 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 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. Dieser Vorgang umfasst die folgenden Schritte:This involves the following steps:

  1. Definieren Sie eine Unterklasse von, die EncodingProvider die beiden abstrakten GetEncoding über Ladungen und überschreibt GetEncoding(Int32) GetEncoding(String) .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 virtuellen GetEncoding(Int32, EncoderFallback, DecoderFallback) Methoden und überschreiben GetEncoding(String, EncoderFallback, DecoderFallback) .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-Objekt bereitgestellten Codierungen EncodingProvider 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 Encoding.GetEncoding Sie 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 bereit, die CodePagesEncodingProvider.Instance ein Objekt zurückgibt, das EncodingProvider den vollständigen Satz von Codierungen, die in der Desktop .NET Framework-Klassenbibliothek verfügbar sind, für .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 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()

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

GetEncodings()

Diese Methode gibt ein Array zurück, das alle Codierungen enthält, die von der EncodingProvider-Klasse unterstützt werden.Returns an array that contains all the encodings that are supported by the EncodingProvider.

GetHashCode()

Fungiert als Standardhashfunktion.Serves 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