Encoding.RegisterProvider(EncodingProvider) Methode

Definition

Registriert einen Codierungsanbieter.Registers an encoding provider.

public:
 static void RegisterProvider(System::Text::EncodingProvider ^ provider);
[System.Security.SecurityCritical]
public static void RegisterProvider (System.Text.EncodingProvider provider);
public static void RegisterProvider (System.Text.EncodingProvider provider);
static member RegisterProvider : System.Text.EncodingProvider -> unit
Public Shared Sub RegisterProvider (provider As EncodingProvider)

Parameter

provider
EncodingProvider

Eine Unterklasse von EncodingProvider, die Zugriff auf zusätzliche Zeichencodierungen bietet.A subclass of EncodingProvider that provides access to additional character encodings.

Attribute

Ausnahmen

provider ist nullprovider is null.

Hinweise

Die RegisterProvider-Methode ermöglicht es Ihnen, eine von EncodingProvider abgeleitete Klasse zu registrieren, die Zeichen Codierungen auf einer Plattform zur Verfügung stellt, von der Sie andernfalls nicht unterstützt werden.The RegisterProvider method allows you to register a class derived from EncodingProvider that makes character encodings available on a platform that does not otherwise support them. Nachdem der Codierungs Anbieter registriert wurde, können die Codierungen, die er unterstützt, durch Aufrufen beliebiger Encoding.GetEncoding Überladungen abgerufen werden.Once the encoding provider is registered, the encodings that it supports can be retrieved by calling any Encoding.GetEncoding overload. Wenn mehrere Codierungs Anbieter vorhanden sind, versucht die Encoding.GetEncoding Methode, eine angegebene Codierung von jedem Anbieter abzurufen, beginnend mit dem zuletzt registrierten.If there are multiple encoding providers, the Encoding.GetEncoding method attempts to retrieve a specified encoding from each provider starting with the one most recently registered.

Durch das Registrieren eines Codierungs Anbieters mithilfe der RegisterProvider-Methode wird auch das Verhalten der Methoden Encoding. GetEncoding (Int32) und encodingprovider. GetEncoding (Int32, EncoderFallback, DecoderFallback) geändert, wenn ein Argument von 0übermittelt wird:Registering an encoding provider by using the RegisterProvider method also modifies the behavior of the Encoding.GetEncoding(Int32) and EncodingProvider.GetEncoding(Int32, EncoderFallback, DecoderFallback) methods when passed an argument of 0:

  • Wenn der registrierte Anbieter die CodePagesEncodingProviderist, gibt die Methode die Codierung zurück, die mit der aktiven System Codepage übereinstimmt, wenn Sie unter dem Windows-Betriebssystem ausgeführt wird.If the registered provider is the CodePagesEncodingProvider, the method returns the encoding that matches the system active code page when running on the Windows operating system.

  • Ein benutzerdefinierter Codierungs Anbieter kann auswählen, welche Codierung zurückgegeben werden soll, wenn einer dieser GetEncoding Methoden Überladungen ein Argument von 0übertragen wird.A custom encoding provider can choose which encoding to return when either of these GetEncoding method overloads is passed an argument of 0. Der Anbieter kann auch auswählen, dass keine Codierung zurückgegeben wird, wenn die EncodingProvider.GetEncoding-Methode nullzurückgibt.The provider can also choose to not return an encoding by having the EncodingProvider.GetEncoding method return null.

Beginnend mit dem .NET Framework 4,6 umfasst der .NET Framework einen Codierungs Anbieter, CodePagesEncodingProvider, der die Codierungen verfügbar macht, die im vollständigen .NET Framework vorhanden sind, aber nicht im universelle Windows-Plattform verfügbar sind.Starting with the .NET Framework 4.6, the .NET Framework includes one encoding provider, CodePagesEncodingProvider, that makes the encodings available that are present in the full .NET Framework but are not available in the Universal Windows Platform. Standardmäßig unterstützt die universelle Windows-Plattform nur die Unicode-Codierungen, ASCII und Codepage 28591.By default, the Universal Windows Platform only supports the Unicode encodings, ASCII, and code page 28591.

Wenn derselbe Codierungs Anbieter in mehreren Aufrufen der RegisterProvider-Methode verwendet wird, registriert nur der erste Methodenaufruf den Anbieter.If the same encoding provider is used in multiple calls to the RegisterProvider method, only the first method call registers the provider. Nachfolgende Aufrufe werden ignoriert.Subsequent calls are ignored.

Wenn die RegisterProvider-Methode aufgerufen wird, um mehrere Anbieter zu registrieren, die dieselbe Codierung verarbeiten, wird der zuletzt registrierte Anbieter für alle Codierungs-und Decodierungs Vorgänge verwendet.If the RegisterProvider method is called to register multiple providers that handle the same encoding, the last registered provider is the used for all encoding and decoding operations. Alle zuvor registrierten Anbieter werden ignoriert.Any previously registered providers are ignored.

Gilt für:

Siehe auch