EncodingProvider Osztály

Definíció

Névtér:

System.Text

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

EncodingProvider.cs

Egy kódolásszolgáltató alaposztályát biztosítja, amely egy adott platformon nem elérhető kódolásokat biztosít.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Öröklődés

Object

EncodingProvider

Származtatott

System.Text.CodePagesEncodingProvider

Megjegyzések

A kódolási szolgáltató olyan kódolásokat biztosít, amelyek egyébként nem érhetők el egy adott célplatformon.

A .NET-keretrendszer számos karakterkódolást és kódlapot támogat. A .NET-keretrendszerben elérhető kódolások teljes listáját a Encoding.GetEncodings metódus meghívásával szerezheti be. .NET Core alapértelmezés szerint csak a következő kódolásokat támogatja:

• ASCII (kódlap 20127), amelyet a tulajdonság ad Encoding.ASCII vissza.

• ISO-8859-1 (kódlap: 28591).

• UTF-7 (kódlap: 65000), amelyet a tulajdonság ad Encoding.UTF7 vissza.

• UTF-8 (kódlap: 65001), amelyet a tulajdonság ad Encoding.UTF8 vissza.

• UTF-16 és UTF-16LE (kódlap 1200), amelyet a Unicode tulajdonság ad vissza.

• UTF-16BE (kódlap: 1201), amelyet a rendszer a konstruktor vagy UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) a UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) konstruktor értékének bigEndianmeghívásával true hoz létre.

• UTF-32 és UTF-32LE (kódlap: 12000), amelyet a tulajdonság ad Encoding.UTF32 vissza.

• UTF-32BE (kódlap: 12001), amely egy paraméterrel rendelkező UTF32Encoding konstruktor meghívásával bigEndian és a metódushívás értékének true megadásával hozható létre.

A .NET Framework 4.6-tól kezdve a EncodingProvider az alaposztály, amely egyébként nem érhető el a .NET-keretrendszer számára. Ez a következő lépéseket foglalja magában:

1. Definiáljon egy alosztályt EncodingProvider , amely felülbírálja a két absztrakt GetEncoding túlterhelést, GetEncoding(Int32) és GetEncoding(String). Ezek a túlterhelések az egyébként nem támogatott kódolást kódlap-azonosító és név alapján adják vissza. Vegye figyelembe, hogy az alapértelmezett kódolást is megadhatja, ha a GetEncoding(Int32) metódust 0 argumentummal hívjuk meg.

2. Igény szerint felülbírálhatja a virtuális GetEncoding(Int32, EncoderFallback, DecoderFallback) és GetEncoding(String, EncoderFallback, DecoderFallback) a metódusokat. A legtöbb esetben ez nem szükséges, mivel az alaposztály alapértelmezett implementációt biztosít.

3. Adja át a példányt EncodingProvider a Encoding.RegisterProvider metódusnak, hogy az objektum által EncodingProvider biztosított kódolásokat elérhetővé tegye a közös nyelvi futtatókörnyezet számára.

4. Túlterhelés hívása Encoding.GetEncoding a kódolás lekéréséhez. A Encoding.GetEncoding metódus meghívja a megfelelőt EncodingProvider.GetEncoding annak megállapításához, hogy meg tudja-e adni a kért kódolást.

A .NET framework class library egy statikus tulajdonságot biztosít CodePagesEncodingProvider.Instance, amely egy EncodingProvider objektumot ad vissza, amely elérhetővé teszi a kódolások teljes készletét az asztali .NET Framework Class Library-ben .NET Core-alkalmazások számára. Emellett az osztályból is származtathatja a EncodingProvider saját kódolásait.

Konstruktorok

Name	Description
EncodingProvider()	Inicializálja a EncodingProvider osztály új példányát.

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
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(Int32)	A megadott kódoldal-azonosítóhoz társított kódolást adja vissza.
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(String)	A megadott névvel rendelkező kódolást adja vissza.
GetEncodings()	Egy tömböt ad vissza, amely tartalmazza a program által támogatott összes kódolást EncodingProvider.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• GetEncoding(String)
• Instance