EncodingProvider.GetEncoding Methode

public:
 abstract System::Text::Encoding ^ GetEncoding(int codepage);

public abstract System.Text.Encoding GetEncoding(int codepage);

abstract member GetEncoding : int -> System.Text.Encoding

Public MustOverride Function GetEncoding (codepage As Integer) As Encoding

Parameters

Retouren

De codering die is gekoppeld aan de opgegeven codepagina, of null als dit EncodingProvider geen geldige codering kan retourneren die overeenkomt met codepage.

Opmerkingen

Notities voor bellers

Deze methode wordt aangeroepen door de methode Encoding.GetEncoding(Int32). U mag deze niet rechtstreeks vanuit de gebruikerscode aanroepen.

Notities voor uitvoerders

U overschrijft de GetEncoding(Int32) methode om de coderings- of coderingen te retourneren die worden ondersteund door uw EncodingProvider subklasse. Wanneer gebruikerscode probeert een codering op te halen door de GetEncoding(Int32) methode aan te roepen, geeft de methode de codepage id door aan elke geregistreerde coderingsprovider totdat één een geldige codering retourneert. Als er geen een geldige codering retourneert, probeert de methode een codering in de cache op te halen waarvan de GetEncoding(Int32) codepagina-id is codepage. Als dit codepage niet de codepagina-id is van een codering die u ondersteunt, moet de methode worden geretourneerd null; er mag nooit een uitzondering worden gegenereerd.

Notities voor bellers

Deze methode wordt aangeroepen door de GetEncoding(Int32) methode. U mag deze niet rechtstreeks vanuit de gebruikerscode aanroepen.

Zie ook

• GetEncoding(Int32)

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);

public abstract System.Text.Encoding GetEncoding(string name);

abstract member GetEncoding : string -> System.Text.Encoding

Public MustOverride Function GetEncoding (name As String) As Encoding

Parameters

Retouren

De codering die is gekoppeld aan de opgegeven naam, of null als dit EncodingProvider geen geldige codering kan retourneren die overeenkomt met name.

Opmerkingen

Notities voor overnemers

U overschrijft de Methode GetEncoding(String) om de coderings- of coderingen te retourneren die worden ondersteund door uw EncodingProvider subklasse. Wanneer gebruikerscode probeert een codering op te halen door de Methode GetEncoding(String) aan te roepen, geeft de methode het name argument door aan elke geregistreerde coderingsprovider totdat een geldige codering wordt geretourneerd. Als er geen een geldige codering retourneert, probeert de Methode GetEncoding(String) een codering in de cache op te halen waarvan de naam is name. Als dit name niet de naam is van een codering die u ondersteunt, moet de methode worden geretourneerd null. Het enige geval waarin de methode een uitzondering moet genereren, is als name dat het geval is null.

Notities voor bellers

Deze methode wordt aangeroepen door de methode Encoding.GetEncoding(String). U mag deze niet rechtstreeks vanuit de gebruikerscode aanroepen.

Notities voor uitvoerders

U overschrijft de GetEncoding(String) methode om de coderings- of coderingen te retourneren die worden ondersteund door uw EncodingProvider subklasse. Wanneer gebruikerscode probeert een codering op te halen door de GetEncoding(String) methode aan te roepen, geeft de methode het name argument door aan elke geregistreerde coderingsprovider totdat een geldige codering wordt geretourneerd. Als er geen een geldige codering retourneert, probeert de methode een codering in de cache op te halen waarvan de GetEncoding(String) naam is name. Als dit name niet de naam is van een codering die u ondersteunt, moet de methode worden geretourneerd null. Het enige geval waarin de methode een uitzondering moet genereren, is als name dat het geval is null.

Notities voor bellers

Deze methode wordt aangeroepen door de GetEncoding(String) methode. U mag deze niet rechtstreeks vanuit de gebruikerscode aanroepen.

Zie ook

• GetEncoding(String)

public:
 virtual System::Text::Encoding ^ GetEncoding(int codepage, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding GetEncoding(int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (codepage As Integer, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parameters

Retouren

De codering die is gekoppeld aan de opgegeven codepagina, of null als dit EncodingProvider geen geldige codering kan retourneren die overeenkomt met codepage.

Opmerkingen

De encoderFallback parameters decoderFallback zijn objecten die de terugvalstrategie definiëren die wordt gebruikt in het geval dat een encoder een teken niet kan converteren naar een reeks bytes of een decoder kan geen reeks bytes converteren naar een teken. .NET Framework biedt de volgende terugvalmechanismen:

• Uitzondering terugval. Als het encoderFallback argument een instantie is van EncoderExceptionFallback, of het decoderExceptionFallback argument een exemplaar DecoderExceptionFallbackis, genereert de coderingsmethode een uitzondering als tekens niet kunnen worden gecodeerd en genereert de decoderingsmethode een uitzondering als een bytereeks niet kan worden gedecodeerd.

• Vervangende terugval. Als het encoderFallback argument een exemplaar is van EncoderReplacementFallback, of het decoderExceptionFallback argument een exemplaar DecoderReplacementFallbackis van, kunnen de coderings- en decoderingsmethoden een vervangende tekenreeks vervangen door tekens die niet kunnen worden gecodeerd en bytereeksen kunnen niet worden gedecodeerd. Als u het vervangende terugvalobject hebt geïnstantieerd door de parameterloze constructor aan te roepen, is het vervangende teken een '?'. Als u de EncoderReplacementFallback.EncoderReplacementFallback(String) of DecoderReplacementFallback.DecoderReplacementFallback(String) constructor aanroept, kunt u de vervangende tekenreeks opgeven.

• Beste terugval. U kunt afleiden van de EncoderFallback of DecoderFallback klasse om een geschikt vervangingsmechanisme te implementeren.

Notities voor overnemers

Omdat aanroepen naar deze methode uw implementatie van de GetEncoding(Int32) methode gebruiken, hoeft u deze niet te overschrijven. Wanneer gebruikerscode probeert een codering op te halen door de GetEncoding(Int32, EncoderFallback, DecoderFallback) methode aan te roepen, geeft de methode de codepage id door aan elke geregistreerde coderingsprovider totdat één een geldige codering retourneert. Als er geen een geldige codering retourneert, probeert de methode een codering in de cache op te halen waarvan de GetEncoding(Int32) codepagina-id is codepage. Als u er wel voor kiest om de GetEncoding(Int32, EncoderFallback, DecoderFallback) methode te overschrijven, moet uw overschrijving worden geretourneerd null als codepage dit niet de codepagina-id is van een codering die u ondersteunt. Er mag nooit een uitzondering worden gegenereerd.

Notities voor bellers

Deze methode wordt aangeroepen door de GetEncoding(Int32, EncoderFallback, DecoderFallback) methode. U mag deze niet rechtstreeks vanuit de gebruikerscode aanroepen.

Zie ook

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

public:
 virtual System::Text::Encoding ^ GetEncoding(System::String ^ name, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding GetEncoding(string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (name As String, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parameters

Retouren

De codering die is gekoppeld aan de opgegeven naam, of null als dit EncodingProvider geen geldige codering kan retourneren die overeenkomt met name.

Opmerkingen

De encoderFallback parameters decoderFallback zijn objecten die de terugvalstrategie definiëren die wordt gebruikt in het geval dat een encoder een teken niet kan converteren naar een reeks bytes of een decoder kan geen reeks bytes converteren naar een teken. .NET biedt de volgende terugvalmechanismen:

• Uitzondering terugval. Als het encoderFallback argument een instantie is van EncoderExceptionFallback, of het decoderExceptionFallback argument een exemplaar DecoderExceptionFallbackis, genereert de coderingsmethode een uitzondering als tekens niet kunnen worden gecodeerd en genereert de decoderingsmethode een uitzondering als een bytereeks niet kan worden gedecodeerd.

• Vervangende terugval. Als het encoderFallback argument een exemplaar is van EncoderReplacementFallback, of het decoderExceptionFallback argument een exemplaar DecoderReplacementFallbackis van, kunnen de coderings- en decoderingsmethoden een vervangende tekenreeks vervangen door tekens die niet kunnen worden gecodeerd en bytereeksen kunnen niet worden gedecodeerd. Als u het vervangende terugvalobject hebt geïnstantieerd door de parameterloze constructor aan te roepen, is het vervangende teken een '?'. Als u de EncoderReplacementFallback.EncoderReplacementFallback(String) of DecoderReplacementFallback.DecoderReplacementFallback(String) constructor aanroept, kunt u de vervangende tekenreeks opgeven.

• Beste terugval. U kunt afleiden van de EncoderFallback of DecoderFallback klasse om een geschikt vervangingsmechanisme te implementeren.

Notities voor bellers

Deze methode wordt aangeroepen door de GetEncoding(String, EncoderFallback, DecoderFallback) methode. U mag deze niet rechtstreeks vanuit de gebruikerscode aanroepen.

Zie ook

• GetEncoding(String, EncoderFallback, DecoderFallback)