EncodingProvider.GetEncoding Metódus

Definíció

Névtér:

System.Text

Szerelvények:

netstandard.dll, System.Runtime.dll

Kódolást ad vissza.

Túlterhelések

Name	Description
GetEncoding(Int32)	A megadott kódoldal-azonosítóhoz társított kódolást adja vissza.
GetEncoding(String)	A megadott névvel rendelkező kódolást adja vissza.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	A megadott kódoldal-azonosítóhoz társított kódolást adja vissza. A paraméterek hibakezelőt adnak a nem kódolható karakterekhez és a nem dekódolható bájtütemezésekhez.
GetEncoding(String, EncoderFallback, DecoderFallback)	A megadott névhez társított kódolást adja vissza. A paraméterek hibakezelőt adnak a nem kódolható karakterekhez és a nem dekódolható bájtütemezésekhez.

GetEncoding(Int32)

Forrás:

EncodingProvider.cs

A megadott kódoldal-azonosítóhoz társított kódolást adja vissza.

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

Paraméterek

codepage

Int32

A kért kódolás kódlapazonosítója.

Válaszok

Encoding

A megadott kódlaphoz társított kódolás, vagy null ha ez EncodingProvider nem tud érvényes kódolást visszaadni codepage.

Megjegyzések

Jegyzetek a hívóknak

Ezt a metódust a Encoding.GetEncoding(Int32) metódus hívja meg. Ne hívja meg közvetlenül a felhasználói kódból.

Megjegyzések az implementálókhoz

Felülbírálhatja a GetEncoding(Int32) metódust, hogy visszaadja az alosztály által EncodingProvider támogatott kódolásokat vagy kódolásokat. Amikor a felhasználói kód megkísérli lekérni a kódolást a GetEncoding(Int32) metódus meghívásával, a metódus átadja az codepage azonosítót minden regisztrált kódolási szolgáltatónak, amíg egy érvényes kódolást nem ad vissza. Ha egyik sem ad vissza érvényes kódolást, a GetEncoding(Int32) metódus megpróbál lekérni egy gyorsítótárazott kódolást, amelynek kódlapazonosítója.codepage Emiatt, ha codepage nem egy támogatott kódolás kódlapazonosítója, akkor a metódusnak vissza kell térnie null; soha ne tegyen kivételt.

Megjegyzések a hívókhoz

Ezt a metódust a GetEncoding(Int32) metódus hívja meg. Ne hívja meg közvetlenül a felhasználói kódból.

Lásd még

• GetEncoding(Int32)

GetEncoding(String)

Forrás:

EncodingProvider.cs

A megadott névvel rendelkező kódolást adja vissza.

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

Paraméterek

name

String

A kért kódolás neve.

Válaszok

Encoding

A megadott névhez társított kódolás, vagy null ha ez EncodingProvider nem tud érvényes kódolást visszaadni, amely megfelel a megadott névnek name.

Megjegyzések

Jegyzetek öröklőknek

Felülbírálhatja a GetEncoding(String) metódust az alosztály által támogatott kódolások vagy kódolások visszaadásához EncodingProvider . Amikor a felhasználói kód a GetEncoding(String) metódus meghívásával próbál kódolást lekérni, a metódus átadja az name argumentumot minden regisztrált kódolási szolgáltatónak, amíg egy érvényes kódolást nem ad vissza. Ha egyik sem ad vissza érvényes kódolást, a GetEncoding(Sztring) metódus megpróbál lekérni egy gyorsítótárazott kódolást, amelynek a neve .name Emiatt, ha name nem a támogatott kódolás neve, a metódusnak vissza kell adnia null. Az egyetlen eset, amikor a metódus kivételt ad, ha name igen null.

Jegyzetek a hívóknak

Ezt a metódust a Encoding.GetEncoding(String) metódus hívja meg. Ne hívja meg közvetlenül a felhasználói kódból.

Megjegyzések az implementálókhoz

Felülbírálhatja a GetEncoding(String) metódust, hogy visszaadja az alosztály által EncodingProvider támogatott kódolásokat vagy kódolásokat. Amikor a felhasználói kód megkísérli lekérni a kódolást a GetEncoding(String) metódus meghívásával, a metódus átadja az name argumentumot minden regisztrált kódolási szolgáltatónak, amíg egy érvényes kódolást nem ad vissza. Ha egyik sem ad vissza érvényes kódolást, a GetEncoding(String) metódus megpróbál lekérni egy gyorsítótárazott kódolást, amelynek a neve .name Emiatt, ha name nem a támogatott kódolás neve, a metódusnak vissza kell adnia null. Az egyetlen eset, amikor a metódus kivételt ad, ha name igen null.

Megjegyzések a hívókhoz

Ezt a metódust a GetEncoding(String) metódus hívja meg. Ne hívja meg közvetlenül a felhasználói kódból.

Lásd még

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Forrás:

EncodingProvider.cs

A megadott kódoldal-azonosítóhoz társított kódolást adja vissza. A paraméterek hibakezelőt adnak a nem kódolható karakterekhez és a nem dekódolható bájtütemezésekhez.

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

Paraméterek

codepage

Int32

A kért kódolás kódlapazonosítója.

encoderFallback

EncoderFallback

Olyan objektum, amely hibakezelési eljárást biztosít, ha egy karakter nem kódolható ezzel a kódolással.

decoderFallback

DecoderFallback

Olyan objektum, amely hibakezelési eljárást biztosít, ha egy bájtsorozat nem dekódolható ezzel a kódolással.

Válaszok

Encoding

A megadott kódlaphoz társított kódolás, vagy null ha ez EncodingProvider nem tud érvényes kódolást visszaadni codepage.

Megjegyzések

A encoderFallback paraméterek olyan decoderFallback objektumok, amelyek meghatározzák a tartalék stratégiát abban az esetben, ha a kódoló nem tud bájtsorozattá alakítani egy karaktert, vagy a dekódoló nem tudja karakterzé konvertálni a bájtok sorozatát. A .NET-keretrendszer a következő tartalék mechanizmusokat biztosítja:

• Kivétel tartaléka. Ha az encoderFallback argumentum a példánya EncoderExceptionFallback, vagy az decoderExceptionFallback argumentum a példánya DecoderExceptionFallback, akkor a kódolási módszer kivételt ad, ha a karakterek nem kódolhatók, és a dekódolási módszer kivételt ad, ha egy bájtsor nem dekódolható.

• Csere tartalék. Ha az encoderFallback argumentum a példánya EncoderReplacementFallback, vagy az decoderExceptionFallback argumentum a példánya DecoderReplacementFallback, akkor a kódolási és dekódolási módszerek helyettesítő sztringet helyettesítenek a nem kódolható karakterekre, és a bájtsorozatok nem dekódolhatók. Ha a paraméter nélküli konstruktor meghívásával példányosítottuk a csere tartalék objektumot, a helyettesítő karakter egy "?". Ha meghívja a EncoderReplacementFallback.EncoderReplacementFallback(String) konstruktort, DecoderReplacementFallback.DecoderReplacementFallback(String) megadhatja a helyettesítő sztringet.

• Legjobban illeszkedő tartalék. A legjobban illeszkedő cseremechanizmus implementálásához az osztályból vagy EncoderFallback az DecoderFallback osztályból származhat.

Megjegyzések az öröklőkhöz

Mivel a metódushoz intézett hívások a GetEncoding(Int32) metódus implementálását használják, nem kell felülbírálnia. Amikor a felhasználói kód megkísérli lekérni a kódolást a GetEncoding(Int32, EncoderFallback, DecoderFallback) metódus meghívásával, a metódus átadja az codepage azonosítót minden regisztrált kódolási szolgáltatónak, amíg egy érvényes kódolást nem ad vissza. Ha egyik sem ad vissza érvényes kódolást, a GetEncoding(Int32) metódus megpróbál lekérni egy gyorsítótárazott kódolást, amelynek kódlapazonosítója.codepage Emiatt, ha a metódus felülbírálása GetEncoding(Int32, EncoderFallback, DecoderFallback) mellett dönt, a felülbírálásnak akkor kell visszaadnia null , ha codepage nem az Ön által támogatott kódolás kódlap-azonosítója, akkor soha ne tegyen kivételt.

Megjegyzések a hívókhoz

Ezt a metódust a GetEncoding(Int32, EncoderFallback, DecoderFallback) metódus hívja meg. Ne hívja meg közvetlenül a felhasználói kódból.

Lásd még

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Forrás:

EncodingProvider.cs

A megadott névhez társított kódolást adja vissza. A paraméterek hibakezelőt adnak a nem kódolható karakterekhez és a nem dekódolható bájtütemezésekhez.

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

Paraméterek

name

String

Az előnyben részesített kódolás neve.

encoderFallback

EncoderFallback

Olyan objektum, amely hibakezelési eljárást biztosít, ha egy karakter nem kódolható ezzel a kódolással.

decoderFallback

DecoderFallback

Olyan objektum, amely hibakezelési eljárást biztosít, ha egy bájtsorozat nem dekódolható az aktuális kódolással.

Válaszok

Encoding

A megadott névhez társított kódolás, vagy null ha ez EncodingProvider nem tud érvényes kódolást visszaadni, amely megfelel a megadott névnek name.

Megjegyzések

A encoderFallback paraméterek olyan decoderFallback objektumok, amelyek meghatározzák a tartalék stratégiát abban az esetben, ha a kódoló nem tud bájtsorozattá alakítani egy karaktert, vagy a dekódoló nem tudja karakterzé konvertálni a bájtok sorozatát. .NET a következő tartalék mechanizmusokat biztosítja:

• Kivétel tartaléka. Ha az encoderFallback argumentum a példánya EncoderExceptionFallback, vagy az decoderExceptionFallback argumentum a példánya DecoderExceptionFallback, akkor a kódolási módszer kivételt ad, ha a karakterek nem kódolhatók, és a dekódolási módszer kivételt ad, ha egy bájtsor nem dekódolható.

• Csere tartalék. Ha az encoderFallback argumentum a példánya EncoderReplacementFallback, vagy az decoderExceptionFallback argumentum a példánya DecoderReplacementFallback, akkor a kódolási és dekódolási módszerek helyettesítő sztringet helyettesítenek a nem kódolható karakterekre, és a bájtsorozatok nem dekódolhatók. Ha a paraméter nélküli konstruktor meghívásával példányosítottuk a csere tartalék objektumot, a helyettesítő karakter egy "?". Ha meghívja a EncoderReplacementFallback.EncoderReplacementFallback(String) konstruktort, DecoderReplacementFallback.DecoderReplacementFallback(String) megadhatja a helyettesítő sztringet.

• Legjobban illeszkedő tartalék. A legjobban illeszkedő cseremechanizmus implementálásához az osztályból vagy EncoderFallback az DecoderFallback osztályból származhat.

Megjegyzések a hívókhoz

Ezt a metódust a GetEncoding(String, EncoderFallback, DecoderFallback) metódus hívja meg. Ne hívja meg közvetlenül a felhasználói kódból.

Lásd még

• GetEncoding(String, EncoderFallback, DecoderFallback)