EncodingProvider.GetEncoding Metod

Definition

Namnområde:

System.Text

Sammansättning:

mscorlib.dll

Returnerar en kodning.

Överlagringar

Name	Description
GetEncoding(Int32)	Returnerar kodningen som är associerad med den angivna kodsideidentifieraren.
GetEncoding(String)	Returnerar kodningen med det angivna namnet.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Returnerar kodningen som är associerad med den angivna kodsideidentifieraren. Parametrar anger en felhanterare för tecken som inte kan kodas och bytesekvenser som inte kan avkodas.
GetEncoding(String, EncoderFallback, DecoderFallback)	Returnerar kodningen som är associerad med det angivna namnet. Parametrar anger en felhanterare för tecken som inte kan kodas och bytesekvenser som inte kan avkodas.

GetEncoding(Int32)

Returnerar kodningen som är associerad med den angivna kodsideidentifieraren.

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

Parametrar

codepage

Int32

Kodsideidentifieraren för den begärda kodningen.

Returer

Encoding

Den kodning som är associerad med den angivna kodsidan, eller null om detta EncodingProvider inte kan returnera en giltig kodning som motsvarar codepage.

Kommentarer

Anteckningar till uppringare

Den här metoden anropas av metoden Encoding.GetEncoding(Int32). Du bör inte anropa det direkt från användarkoden.

Anteckningar till implementerare

Du åsidosätter GetEncoding(Int32) metoden för att returnera kodning eller kodningar som stöds av din EncodingProvider underklass. När användarkoden försöker hämta en kodning genom att anropa GetEncoding(Int32) metoden skickar metoden identifieraren codepage till varje registrerad kodningsprovider tills en returnerar en giltig kodning. Om ingen returnerar en giltig kodning GetEncoding(Int32) försöker metoden hämta en cachelagrad kodning vars kodsideidentifierare är codepage. På grund av detta, om codepage inte är kodsideidentifieraren för en kodning som du stöder, bör metoden returnera null. Den bör aldrig utlösa ett undantag.

Anteckningar till anropare

Den här metoden anropas av GetEncoding(Int32) metoden. Du bör inte anropa det direkt från användarkoden.

Se även

• GetEncoding(Int32)

GetEncoding(String)

Returnerar kodningen med det angivna namnet.

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

Parametrar

name

String

Namnet på den begärda kodningen.

Returer

Encoding

Kodningen som är associerad med det angivna namnet, eller null om detta EncodingProvider inte kan returnera en giltig kodning som motsvarar name.

Kommentarer

Anteckningar till arvtagare

Du åsidosätter metoden GetEncoding(String) för att returnera kodning eller kodningar som stöds av underklassen EncodingProvider . När användarkoden försöker hämta en kodning genom att anropa metoden GetEncoding(String) skickar name metoden argumentet till varje registrerad kodningsprovider tills en returnerar en giltig kodning. Om ingen returnerar en giltig kodning försöker metoden GetEncoding(String) hämta en cachelagrad kodning vars namn är name. På grund av detta, om name inte är namnet på en kodning som du stöder, bör metoden returnera null. Det enda fallet där metoden ska utlösa ett undantag är om name är null.

Anteckningar till uppringare

Den här metoden anropas av metoden Encoding.GetEncoding(String). Du bör inte anropa det direkt från användarkoden.

Anteckningar till implementerare

Du åsidosätter GetEncoding(String) metoden för att returnera kodning eller kodningar som stöds av din EncodingProvider underklass. När användarkoden försöker hämta en kodning genom att anropa GetEncoding(String) metoden skickar name metoden argumentet till varje registrerad kodningsprovider tills en returnerar en giltig kodning. Om ingen returnerar en giltig kodning GetEncoding(String) försöker metoden hämta en cachelagrad kodning vars namn är name. På grund av detta, om name inte är namnet på en kodning som du stöder, bör metoden returnera null. Det enda fallet där metoden ska utlösa ett undantag är om name är null.

Anteckningar till anropare

Den här metoden anropas av GetEncoding(String) metoden. Du bör inte anropa det direkt från användarkoden.

Se även

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Returnerar kodningen som är associerad med den angivna kodsideidentifieraren. Parametrar anger en felhanterare för tecken som inte kan kodas och bytesekvenser som inte kan avkodas.

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

Parametrar

codepage

Int32

Kodsideidentifieraren för den begärda kodningen.

encoderFallback

EncoderFallback

Ett objekt som tillhandahåller en felhanteringsprocedur när ett tecken inte kan kodas med den här kodningen.

decoderFallback

DecoderFallback

Ett objekt som tillhandahåller en felhanteringsprocedur när en bytesekvens inte kan avkodas med den här kodningen.

Returer

Encoding

Den kodning som är associerad med den angivna kodsidan, eller null om detta EncodingProvider inte kan returnera en giltig kodning som motsvarar codepage.

Kommentarer

Parametrarna encoderFallback och decoderFallback är objekt som definierar reservstrategin som används i händelse av att en kodare inte kan konvertera ett tecken till en sekvens med byte eller om en avkodare inte kan konvertera en sekvens med byte till ett tecken. .NET Framework tillhandahåller följande reservmekanismer:

• Undantagsåterställning. encoderFallback Om argumentet är en instans av EncoderExceptionFallback, eller decoderExceptionFallback om argumentet är en instans av DecoderExceptionFallback, utlöser kodningsmetoden ett undantag om tecken inte kan kodas, och avkodningsmetoden utlöser ett undantag om en bytesekvens inte kan avkodas.

• Ersättningsåterställning. encoderFallback Om argumentet är en instans av EncoderReplacementFallback, eller decoderExceptionFallback om argumentet är en instans av , ersätter kodnings- och avkodningsmetoderna DecoderReplacementFallbacken ersättningssträng för tecken som inte kan kodas och bytesekvenser kan inte avkodas. Om du instansierade ersättningsåterställningsobjektet genom att anropa den parameterlösa konstruktorn är ersättningstecknet ett "?". Om du anropar EncoderReplacementFallback.EncoderReplacementFallback(String) konstruktorn eller DecoderReplacementFallback.DecoderReplacementFallback(String) kan du ange ersättningssträngen.

• Best-fit reserv. Du kan härleda från EncoderFallback klassen eller DecoderFallback för att implementera en ersättningsmekanism som passar bäst.

Anteckningar till arvingar

Eftersom anrop till den här metoden använder din implementering av GetEncoding(Int32) metoden behöver du inte åsidosätta den. När användarkoden försöker hämta en kodning genom att anropa GetEncoding(Int32, EncoderFallback, DecoderFallback) metoden skickar metoden identifieraren codepage till varje registrerad kodningsprovider tills en returnerar en giltig kodning. Om ingen returnerar en giltig kodning GetEncoding(Int32) försöker metoden hämta en cachelagrad kodning vars kodsideidentifierare är codepage. Om du väljer att åsidosätta metoden bör åsidosättningen GetEncoding(Int32, EncoderFallback, DecoderFallback) därför returneras null om codepage det inte är kodsideidentifieraren för en kodning som du stöder. Det bör aldrig utlösa ett undantag.

Anteckningar till anropare

Den här metoden anropas av GetEncoding(Int32, EncoderFallback, DecoderFallback) metoden. Du bör inte anropa det direkt från användarkoden.

Se även

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Returnerar kodningen som är associerad med det angivna namnet. Parametrar anger en felhanterare för tecken som inte kan kodas och bytesekvenser som inte kan avkodas.

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

Parametrar

name

String

Namnet på den föredragna kodningen.

encoderFallback

EncoderFallback

Ett objekt som tillhandahåller en felhanteringsprocedur när ett tecken inte kan kodas med den här kodningen.

decoderFallback

DecoderFallback

Ett objekt som tillhandahåller en felhanteringsprocedur när en bytesekvens inte kan avkodas med den aktuella kodningen.

Returer

Encoding

Kodningen som är associerad med det angivna namnet, eller null om detta EncodingProvider inte kan returnera en giltig kodning som motsvarar name.

Kommentarer

Parametrarna encoderFallback och decoderFallback är objekt som definierar reservstrategin som används i händelse av att en kodare inte kan konvertera ett tecken till en sekvens med byte eller om en avkodare inte kan konvertera en sekvens med byte till ett tecken. .NET tillhandahåller följande reservmekanismer:

• Undantagsåterställning. encoderFallback Om argumentet är en instans av EncoderExceptionFallback, eller decoderExceptionFallback om argumentet är en instans av DecoderExceptionFallback, utlöser kodningsmetoden ett undantag om tecken inte kan kodas, och avkodningsmetoden utlöser ett undantag om en bytesekvens inte kan avkodas.

• Ersättningsåterställning. encoderFallback Om argumentet är en instans av EncoderReplacementFallback, eller decoderExceptionFallback om argumentet är en instans av , ersätter kodnings- och avkodningsmetoderna DecoderReplacementFallbacken ersättningssträng för tecken som inte kan kodas och bytesekvenser kan inte avkodas. Om du instansierade ersättningsåterställningsobjektet genom att anropa den parameterlösa konstruktorn är ersättningstecknet ett "?". Om du anropar EncoderReplacementFallback.EncoderReplacementFallback(String) konstruktorn eller DecoderReplacementFallback.DecoderReplacementFallback(String) kan du ange ersättningssträngen.

• Best-fit reserv. Du kan härleda från EncoderFallback klassen eller DecoderFallback för att implementera en ersättningsmekanism som passar bäst.

Anteckningar till anropare

Den här metoden anropas av GetEncoding(String, EncoderFallback, DecoderFallback) metoden. Du bör inte anropa det direkt från användarkoden.

Se även

• GetEncoding(String, EncoderFallback, DecoderFallback)