EncodingProvider.GetEncoding Metoda

Definice

Obor názvů:

System.Text

Sestavení:

System.Runtime.dll

Vrátí kódování.

Přetížení

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 zakódovat, a sekvence bajtů, 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 zakódovat, a sekvence bajtů, 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 EncodingProvider nemůže vrátit platné kódování, které odpovídá codepage.

Poznámky

Poznámky pro volající

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

Poznámky pro implementátory

Přepíšete metodu GetEncoding(Int32) tak, aby vrátila 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(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í uložené v mezipaměti, jehož identifikátor znakové stránky je codepage. Z tohoto důvodu platí, že pokud codepage není identifikátor znakové stránky kódování, které podporujete, měla by metoda 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 EncodingProvider nemůže vrátit platné kódování, které odpovídá name.

Poznámky

Poznámky pro dědice

Přepíšete Metodu GetEncoding(String) tak, aby vrátila 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 Metody GetEncoding(String), 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í uložené v mezipaměti, jehož název je name. Z tohoto důvodu, pokud name není název kódování, které podporujete, metoda by měla vrátit null. Jediný případ, ve kterém by metoda měla vyvolat výjimku, je, pokud name je null.

Poznámky pro volající

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

Poznámky pro implementátory

Přepíšete metodu GetEncoding(String) tak, aby vrátila 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) 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í uložené v mezipaměti s názvem name. Z tohoto důvodu, pokud name není název kódování, které podporujete, metoda by měla vrátit null. Jediný případ, ve kterém 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 zakódovat, a sekvence bajtů, 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 kódovat pomocí tohoto kódování.

decoderFallback

DecoderFallback

Objekt, který poskytuje proceduru zpracování chyb, pokud posloupnost bajtů nelze dekódovat s 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 EncodingProvider nemůže vrátit platné kódování, které odpovídá codepage.

Poznámky

Parametry encoderFallback a decoderFallback 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. Rozhraní .NET Framework poskytuje následující záložní mechanismy:

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

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

• Nejvhodnější náhradní řešení. Můžete odvodit z EncoderFallback třídy nebo DecoderFallback k implementaci nejvhodnějšího mechanismu nahrazení.

Poznámky pro dědice

Vzhledem k tomu, že volání této metody používají implementaci GetEncoding(Int32) metody, není nutné 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í uložené v mezipaměti, jehož identifikátor znakové stránky je codepage. Z tohoto důvodu platí, že pokud se rozhodnete přepsat metodu GetEncoding(Int32, EncoderFallback, DecoderFallback) , mělo by přepsání vrátit null , pokud codepage není identifikátorem znakové stránky kódování, které podporujete. Nikdy by nemělo 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 zakódovat, a sekvence bajtů, 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 kódovat pomocí tohoto kódování.

decoderFallback

DecoderFallback

Objekt, který poskytuje proceduru zpracování chyb, když posloupnost 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 EncodingProvider nemůže vrátit platné kódování, které odpovídá name.

Poznámky

Parametry encoderFallback a decoderFallback 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. Rozhraní .NET Framework poskytuje následující záložní mechanismy:

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

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

• Nejvhodnější náhradní řešení. Můžete odvodit z EncoderFallback třídy nebo DecoderFallback k implementaci nejvhodnějšího mechanismu nahrazení.

Poznámky pro dědice

Vzhledem k tomu, že volání této metody používají implementaci GetEncoding(String) metody, není nutné ji přepsat. Když se uživatelský kód pokusí načíst kódování voláním GetEncoding(String, 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í uložené v mezipaměti, jehož identifikátor znakové stránky je codepage. Z tohoto důvodu platí, že pokud se rozhodnete přepsat metodu GetEncoding(Int32, EncoderFallback, DecoderFallback) , mělo by přepsání vrátit null , pokud codepage není identifikátorem znakové stránky kódování, které podporujete. Nikdy by nemělo vyvolat výjimku.

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)