EncodingProvider.GetEncoding Metoda

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Runtime.dll

Vrátí kódování.

Přetížení

Name	Description
GetEncoding(Int32)	Vrátí kódování přidružené k zadanému identifikátoru znakové stránky.
GetEncoding(String)	Vrátí kódování se zadaným názvem.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Vrátí kódování přidružené k zadanému identifikátoru znakové stránky. Parametry určují obslužnou rutinu chyby pro znaky, které nelze kódovat, a bajtové sekvence, které nelze dekódovat.
GetEncoding(String, EncoderFallback, DecoderFallback)	Vrátí kódování přidružené k zadanému názvu. Parametry určují obslužnou rutinu chyby pro znaky, které nelze kódovat, a bajtové sekvence, které nelze dekódovat.

GetEncoding(Int32)

Zdroj:

EncodingProvider.cs

Vrátí kódování přidružené k zadanému identifikátoru znakové stránky.

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

Parametry

codepage

Int32

Identifikátor znakové stránky požadovaného kódování.

Návraty

Encoding

Kódování, které je přidruženo k zadané znakové stránce, nebo null pokud to EncodingProvider nemůže vrátit platné kódování, které odpovídá codepage.

Poznámky

Poznámky volajícím

Tato metoda se volá metodou Encoding.GetEncoding(Int32). Neměli byste ho volat přímo z uživatelského kódu.

Poznámky pro implementátory

Přepíšete metodu GetEncoding(Int32) pro vrácení kódování nebo kódování podporovaných vaší EncodingProvider podtřídou. Když se uživatelský kód pokusí načíst kódování voláním GetEncoding(Int32) metody, metoda předá codepage identifikátor každému registrovanému zprostředkovateli kódování, dokud nevrátí platné kódování. Pokud žádná nevrátí platné kódování, GetEncoding(Int32) metoda se pokusí načíst kódování v mezipaměti, jehož kódová stránka identifikátor je codepage. Z tohoto důvodu, pokud codepage není identifikátor znakové stránky kódování, které podporujete, by metoda měla vrátit null; nikdy by neměla vyvolat výjimku.

Poznámky pro volající

Tato metoda je volána metodou GetEncoding(Int32) . Neměli byste ho volat přímo z uživatelského kódu.

Viz také

• GetEncoding(Int32)

GetEncoding(String)

Zdroj:

EncodingProvider.cs

Vrátí kódování se zadaným názvem.

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

Parametry

name

String

Název požadovaného kódování.

Návraty

Encoding

Kódování, které je přidruženo k zadanému názvu, nebo null pokud to EncodingProvider nemůže vrátit platné kódování, které odpovídá name.

Poznámky

Poznámky pro dědiče

Přepíšete GetEncoding(String) metodu pro vrácení kódování nebo kódování podporované vaší EncodingProvider podtřídou. Když se uživatelský kód pokusí načíst kódování voláním GetEncoding(String) metoda, metoda předá name argument každému registrovanému zprostředkovateli kódování, dokud jeden nevrátí platné kódování. Pokud žádná nevrátí platné kódování, GetEncoding(String) metoda se pokusí načíst kódování v mezipaměti, jehož název je name. Z tohoto důvodu, pokud name není název kódování, které podporujete, by metoda měla vrátit null. Jediný případ, kdy by metoda měla vyvolat výjimku je pokud name je null.

Poznámky volajícím

Tato metoda se volá metodou Encoding.GetEncoding(String). Neměli byste ho volat přímo z uživatelského kódu.

Poznámky pro implementátory

Přepíšete metodu GetEncoding(String) pro vrácení kódování nebo kódování podporovaných vaší EncodingProvider podtřídou. Když se uživatelský kód pokusí načíst kódování voláním GetEncoding(String) metody, metoda předá name argument každému registrovanému zprostředkovateli kódování, dokud nevrátí platné kódování. Pokud žádná nevrátí platné kódování, GetEncoding(String) metoda se pokusí načíst kódování v mezipaměti, jehož název je name. Z tohoto důvodu, pokud name není název kódování, které podporujete, by metoda měla vrátit null. Jediný případ, kdy by metoda měla vyvolat výjimku je pokud name je null.

Poznámky pro volající

Tato metoda je volána metodou GetEncoding(String) . Neměli byste ho volat přímo z uživatelského kódu.

Viz také

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Zdroj:

EncodingProvider.cs

Vrátí kódování přidružené k zadanému identifikátoru znakové stránky. Parametry určují obslužnou rutinu chyby pro znaky, které nelze kódovat, a bajtové sekvence, které nelze dekódovat.

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

Parametry

codepage

Int32

Identifikátor znakové stránky požadovaného kódování.

encoderFallback

EncoderFallback

Objekt, který poskytuje proceduru zpracování chyb, pokud znak nelze zakódovat pomocí tohoto kódování.

decoderFallback

DecoderFallback

Objekt, který poskytuje proceduru zpracování chyb v případě, že sekvence bajtů nemůže být dekódována tímto kódováním.

Návraty

Encoding

Kódování, které je přidruženo k zadané znakové stránce, nebo null pokud to EncodingProvider nemůže vrátit platné kódování, které odpovídá codepage.

Poznámky

Parametry encoderFallbackdecoderFallback jsou objekty, které definují záložní strategii použitou v případě, že kodér nemůže převést znak na posloupnost bajtů nebo dekodér nemůže převést posloupnost bajtů na znak. Architektura .NET poskytuje následující záložní mechanismy:

• Náhradní výjimka. encoderFallback Pokud je argument instance EncoderExceptionFallback, nebo decoderExceptionFallback argument je instance DecoderExceptionFallback, kódování metoda vyvolá výjimku, pokud znaky nelze zakódovat, a dekódovací metoda vyvolá výjimku, pokud sekvence bajtů nelze dekódovat.

• Náhradní náhradní. encoderFallback Je-li argument instance EncoderReplacementFallback, nebo decoderExceptionFallback argument je instance DecoderReplacementFallback, kódování a dekódování metody nahrazují náhradní řetězec pro znaky, které nelze zakódovat a bajtové sekvence nelze dekódovat. Pokud jste vytvořili instanci náhradního náhradního objektu voláním konstruktoru bez parametrů, náhradní znak je "?". Pokud zavoláte EncoderReplacementFallback.EncoderReplacementFallback(String) nebo DecoderReplacementFallback.DecoderReplacementFallback(String) konstruktor, můžete zadat náhradní řetězec.

• Nejlepší náhradní řešení. Můžete odvodit z EncoderFallback třídy nebo DecoderFallback implementovat nejlepší mechanismus nahrazení.

Poznámky pro dědice

Vzhledem k tomu, že volání této metody používají vaši implementaci GetEncoding(Int32) metody, nemusíte ji přepsat. Když se uživatelský kód pokusí načíst kódování voláním GetEncoding(Int32, EncoderFallback, DecoderFallback) metody, metoda předá codepage identifikátor každému registrovanému zprostředkovateli kódování, dokud nevrátí platné kódování. Pokud žádná nevrátí platné kódování, GetEncoding(Int32) metoda se pokusí načíst kódování v mezipaměti, jehož kódová stránka identifikátor je codepage. Z tohoto důvodu, pokud se rozhodnete přepsat metodu GetEncoding(Int32, EncoderFallback, DecoderFallback) , by se vaše přepsání mělo vrátit null , pokud codepage není identifikátor znakové stránky kódování, které podporujete. Nikdy by neměl vyvolat výjimku.

Poznámky pro volající

Tato metoda je volána metodou GetEncoding(Int32, EncoderFallback, DecoderFallback) . Neměli byste ho volat přímo z uživatelského kódu.

Viz také

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Zdroj:

EncodingProvider.cs

Vrátí kódování přidružené k zadanému názvu. Parametry určují obslužnou rutinu chyby pro znaky, které nelze kódovat, a bajtové sekvence, které nelze dekódovat.

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

Parametry

name

String

Název upřednostňovaného kódování.

encoderFallback

EncoderFallback

Objekt, který poskytuje proceduru zpracování chyb, pokud znak nelze zakódovat pomocí tohoto kódování.

decoderFallback

DecoderFallback

Objekt, který poskytuje proceduru zpracování chyb, pokud sekvence bajtů nelze dekódovat s aktuálním kódováním.

Návraty

Encoding

Kódování, které je přidruženo k zadanému názvu, nebo null pokud to EncodingProvider nemůže vrátit platné kódování, které odpovídá name.

Poznámky

Parametry encoderFallbackdecoderFallback jsou objekty, které definují záložní strategii použitou v případě, že kodér nemůže převést znak na posloupnost bajtů nebo dekodér nemůže převést posloupnost bajtů na znak. .NET poskytuje následující záložní mechanismy:

• Náhradní výjimka. encoderFallback Pokud je argument instance EncoderExceptionFallback, nebo decoderExceptionFallback argument je instance DecoderExceptionFallback, kódování metoda vyvolá výjimku, pokud znaky nelze zakódovat, a dekódovací metoda vyvolá výjimku, pokud sekvence bajtů nelze dekódovat.

• Náhradní náhradní. encoderFallback Je-li argument instance EncoderReplacementFallback, nebo decoderExceptionFallback argument je instance DecoderReplacementFallback, kódování a dekódování metody nahrazují náhradní řetězec pro znaky, které nelze zakódovat a bajtové sekvence nelze dekódovat. Pokud jste vytvořili instanci náhradního náhradního objektu voláním konstruktoru bez parametrů, náhradní znak je "?". Pokud zavoláte EncoderReplacementFallback.EncoderReplacementFallback(String) nebo DecoderReplacementFallback.DecoderReplacementFallback(String) konstruktor, můžete zadat náhradní řetězec.

• Nejlepší náhradní řešení. Můžete odvodit z EncoderFallback třídy nebo DecoderFallback implementovat nejlepší mechanismus nahrazení.

Poznámky pro volající

Tato metoda je volána metodou GetEncoding(String, EncoderFallback, DecoderFallback) . Neměli byste ho volat přímo z uživatelského kódu.

Viz také

• GetEncoding(String, EncoderFallback, DecoderFallback)