Encoding.RegisterProvider(EncodingProvider) Metoda

  • Reference

Definice

Obor názvů:
System.Text
Sestavení:
System.Text.Encoding.dll
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
mscorlib.dll

Zaregistruje poskytovatele kódování.

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)

Parametry

provider
EncodingProvider

Podtřída EncodingProvider , která poskytuje přístup k dodatečným kódováním znaků.

Atributy
SecurityCriticalAttribute

Výjimky

ArgumentNullException

provider je null.

Poznámky

RegisterProviderMetoda umožňuje zaregistrovat třídu odvozenou z EncodingProvider , která umožňuje kódování znaků, které je k dispozici na platformě, která je jinak nepodporuje. Jakmile je poskytovatel kódování zaregistrován, kódování, které podporuje, lze načíst voláním jakéhokoliv Encoding.GetEncoding přetížení. Pokud existuje více zprostředkovatelů kódování, Encoding.GetEncoding metoda se pokusí načíst zadané kódování od každého poskytovatele počínaje poslední registrací.

Registrace zprostředkovatele kódování pomocí RegisterProvider metody také upraví chování metod Encoding. GetEncoding (Int32) a EncodingProvider. GetEncoding (Int32, EncoderFallback, DecoderFallback) při předání argumentu 0 :

  • pokud je registrovaný poskytovatel CodePagesEncodingProvider , metoda vrátí kódování, které se shoduje se systémovou aktivní znakovou stránkou při spuštění v operačním systému Windows.

  • Vlastní zprostředkovatel kódování může zvolit, které kódování se má vrátit, pokud se některá z těchto GetEncoding metod přetížení předává argumentu 0 . Poskytovatel může také zvolit, že nevrátí kódování, pomocí EncodingProvider.GetEncoding metody vrátí null .

počínaje .NET Framework 4,6 .NET Framework zahrnuje jednoho zprostředkovatele kódování, CodePagesEncodingProvider který zpřístupňuje kódování, která jsou k dispozici v plném .NET Framework, ale nejsou k dispozici v Univerzální platforma Windows. ve výchozím nastavení Univerzální platforma Windows podporuje pouze kódování Unicode, znakovou stránku 28591.

Pokud je stejný zprostředkovatel kódování použit v několika voláních RegisterProvider metody, pouze první volání metody zaregistruje poskytovatele. Následná volání jsou ignorována.

Pokud RegisterProvider je metoda volána k registraci více zprostředkovatelů, které zpracovávají stejné kódování, je poslední registrovaný poskytovatel použit pro všechny operace kódování a dekódování. Všichni dřív registrovaní zprostředkovatelé se ignorují.

Platí pro

Viz také