Encoding.RegisterProvider(EncodingProvider) Methode

  • Referenz

Definition

Namespace:
System.Text
Assembly:
System.Text.Encoding.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Registriert einen Codierungsanbieter.

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);
[<System.Security.SecurityCritical>]
static member RegisterProvider : System.Text.EncodingProvider -> unit
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.

Attribute
SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

provider ist null.

Hinweise

Die- RegisterProvider Methode ermöglicht es Ihnen, eine von abgeleitete Klasse zu registrieren EncodingProvider , die Zeichen Codierungen auf einer Plattform verfügbar macht, die Sie nicht anderweitig unterstützt. Nachdem der Codierungs Anbieter registriert wurde, können die Codierungen, die er unterstützt, durch Aufrufen einer beliebigen Überladung abgerufen werden Encoding.GetEncoding . Wenn mehrere Codierungs Anbieter vorhanden sind, Encoding.GetEncoding versucht die-Methode, eine angegebene Codierung von jedem Anbieter abzurufen, beginnend mit dem zuletzt registrierten.

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 übermittelt wird 0 :

  • Wenn der registrierte Anbieter ist CodePagesEncodingProvider , gibt die Methode die Codierung zurück, die der aktiven System Codepage bei Ausführung unter dem Windows-Betriebssystem entspricht.

  • Ein benutzerdefinierter Codierungs Anbieter kann auswählen, welche Codierung zurückgegeben werden soll, wenn GetEncoding einer dieser Methoden Überladungen ein Argument von übergangen wird 0 . Der Anbieter kann auch auswählen, dass keine Codierung zurückgegeben werden soll, wenn die EncodingProvider.GetEncoding Methode zurückgibt null .

Ab .NET Framework 4,6 umfasst .NET Framework einen Codierungs Anbieter, CodePagesEncodingProvider , der die Codierungen verfügbar macht, die in der vollständigen .NET Framework vorhanden sind, aber nicht in der universelle Windows-Plattform verfügbar sind. Standardmäßig unterstützt die universelle Windows-Plattform nur die Unicode-Codierungen, ASCII und Codepage 28591.

Wenn derselbe Codierungs Anbieter in mehreren Aufrufen der-Methode verwendet wird RegisterProvider , registriert nur der erste Methodenaufruf den Anbieter. Nachfolgende Aufrufe werden ignoriert.

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. Alle zuvor registrierten Anbieter werden ignoriert.

Gilt für

Siehe auch