.NET Framework 4 

 

表示字符编码。

 

命名空间:  System.Text
程序集:  mscorlib(在 mscorlib.dll 中)

语法

 

C#
 
[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class Encoding : ICloneable

Encoding 类型公开以下成员。

构造函数


显示:
  名称 说明
Encoding() Encoding 类的新实例。
Encoding(Int32) Encoding 类的新实例。

属性


显示:
  名称 说明
ASCII 获取 ASCII(7 位)字符集的编码。
BigEndianUnicode 获取使用 Big Endian 字节顺序的 UTF-16 格式的编码。
BodyName 在派生类中重写时,获取可与邮件代理正文标记一起使用的当前编码的名称。
CodePage Encoding 的代码页标识符。
DecoderFallback DecoderFallback 对象。
Default 获取操作系统的当前 ANSI 代码页的编码。
EncoderFallback EncoderFallback 对象。
EncodingName 在派生类中重写时,获取当前编码的可读说明。
HeaderName 在派生类中重写时,获取可与邮件代理标题标记一起使用的当前编码的名称。
IsBrowserDisplay 在派生类中重写时,获取一个值,该值指示浏览器客户端是否可以使用当前的编码显示内容。
IsBrowserSave 在派生类中重写时,获取一个值,该值指示浏览器客户端是否可以使用当前的编码保存内容。
IsMailNewsDisplay 在派生类中重写时,获取一个值,该值指示邮件和新闻客户端是否可以使用当前的编码显示内容。
IsMailNewsSave 在派生类中重写时,获取一个值,该值指示邮件和新闻客户端是否可以使用当前的编码保存内容。
IsReadOnly 在派生类中重写时,获取一个值,该值指示当前的编码是否为只读。
IsSingleByte 在派生类中重写时,获取一个值,该值指示当前的编码是否使用单字节码位。
Unicode 获取使用 Little-Endian 字节顺序的 UTF-16 格式的编码。
UTF32 获取使用 Little-Endian 字节顺序的 UTF-32 格式的编码。
UTF7 获取 UTF-7 格式的编码。
UTF8 获取 UTF-8 格式的编码。
WebName 在派生类中重写时,获取在 Internet 编号分配管理机构 (IANA) 注册的当前编码的名称。
WindowsCodePage 在派生类中重写时,获取与当前编码最紧密对应的 Windows 操作系统代码页。

方法


显示:
  名称 说明
Clone Encoding 对象的一个浅表副本。
Convert(Encoding, Encoding, Byte[]) 将整个字节数组从一种编码转换为另一种编码。
Convert(Encoding, Encoding, Byte[], Int32, Int32) 将字节数组内某个范围的字节从一种编码转换为另一种编码。
Equals Object.Equals(Object)。)
Finalize Object。)
GetByteCount(Char[]) 在派生类中重写时,计算对指定字符数组中的所有字符进行编码所产生的字节数。
GetByteCount(String) 在派生类中重写时,计算对指定字符串中的字符进行编码所产生的字节数。
GetByteCount(Char*, Int32) 在派生类中重写时,计算对一组字符(从指定的字符指针处开始)进行编码所产生的字节数。
GetByteCount(Char[], Int32, Int32) 在派生类中重写时,计算对指定字符数组中的一组字符进行编码所产生的字节数。
GetBytes(Char[]) 在派生类中重写时,将指定字符数组中的所有字符编码为一个字节序列。
GetBytes(String) 在派生类中重写时,将指定字符串中的所有字符编码为一个字节序列。
GetBytes(Char[], Int32, Int32) 在派生类中重写时,将指定字符数组中的一组字符编码为一个字节序列。
GetBytes(Char*, Int32, Byte*, Int32) 在派生类中重写时,将一组字符(从指定的字符指针开始)编码为一个字节序列,并从指定的字节指针开始存储该字节序列。
GetBytes(Char[], Int32, Int32, Byte[], Int32) 在派生类中重写时,将指定字符数组中的一组字符编码为指定的字节数组。
GetBytes(String, Int32, Int32, Byte[], Int32) 在派生类中重写时,将指定字符串中的一组字符编码为指定的字节数组。
GetCharCount(Byte[]) 在派生类中重写时,计算对指定字节数组中的所有字节进行解码所产生的字符数。
GetCharCount(Byte*, Int32) 在派生类中重写时,计算对字节序列(从指定的字节指针开始)进行解码所产生的字符数。
GetCharCount(Byte[], Int32, Int32) 在派生类中重写时,计算对字节序列(从指定字节数组开始)进行解码所产生的字符数。
GetChars(Byte[]) 在派生类中重写时,将指定字节数组中的所有字节解码为一组字符。
GetChars(Byte[], Int32, Int32) 在派生类中重写时,将指定字节数组中的一个字节序列解码为一组字符。
GetChars(Byte*, Int32, Char*, Int32) 在派生类中重写时,将一个字节序列(从指定的字节指针开始)解码为一组字符,并从指定的字符指针开始存储该组字符。
GetChars(Byte[], Int32, Int32, Char[], Int32) 在派生类中重写时,将指定字节数组中的字节序列解码为指定的字符数组。
GetDecoder 在派生类中重写时,获取一个解码器,该解码器将已编码的字节序列转换为字符序列。
GetEncoder 在派生类中重写时,获取一个解码器,该解码器将 Unicode 字符序列转换为已编码的字节序列。
GetEncoding(Int32) 返回与指定代码页标识符关联的编码。
GetEncoding(String) 返回与指定代码页名称关联的编码。
GetEncoding(Int32, EncoderFallback, DecoderFallback) 参数指定一个错误处理程序,用于处理无法编码的字符和无法解码的字节序列。
GetEncoding(String, EncoderFallback, DecoderFallback) 参数指定一个错误处理程序,用于处理无法编码的字符和无法解码的字节序列。
GetEncodings 返回包含所有编码的数组。
GetHashCode Object.GetHashCode()。)
GetMaxByteCount 在派生类中重写时,计算对指定数目的字符进行编码所产生的最大字节数。
GetMaxCharCount 在派生类中重写时,计算对指定数目的字节进行解码时所产生的最大字符数。
GetPreamble 在派生类中重写时,返回指定所用编码的字节序列。
GetString(Byte[]) 在派生类中重写时,将指定字节数组中的所有字节解码为一个字符串。
GetString(Byte[], Int32, Int32) 在派生类中重写时,将指定字节数组中的一个字节序列解码为一个字符串。
GetType Object。)
IsAlwaysNormalized() 使用默认范式获取一个值,该值指示当前编码是否始终被规范化。
IsAlwaysNormalized(NormalizationForm) 在派生类中重写时,使用指定范式获取一个值,该值指示当前编码是否始终被规范化。
MemberwiseClone Object。)
ToString Object。)

备注


.NET Framework 中的字符编码。

Convert.ToBase64CharArray 之类的方法实现的协议(如 uuencode)。

Encoding 类的实现以支持当前 Unicode 编码和其他编码:

  • ASCII 属性获得。

  • UTF7 属性获得。

  • UTF8 属性获得。

  • BigEndianUnicode 属性获得。

  • UTF32 属性获得。

通常,对于您的应用程序来说,某个派生的 Unicode 类是不错的选择。

GetEncodings 方法来获得所有编码的列表。

最后一列中的星号指示 .NET Framework 本身即支持该代码页,而不需考虑基础平台。

 

代码页

Name

显示名称

 

37

IBM037

IBM EBCDIC(美国 - 加拿大)

 

437

IBM437

OEM 美国

 

500

IBM500

IBM EBCDIC(国际)

 

708

ASMO-708

阿拉伯字符 (ASMO 708)

 

720

DOS-720

阿拉伯字符 (DOS)

 

737

ibm737

希腊字符 (DOS)

 

775

ibm775

波罗的海字符 (DOS)

 

850

ibm850

西欧字符 (DOS)

 

852

ibm852

中欧字符 (DOS)

 

855

IBM855

OEM 西里尔语

 

857

ibm857

土耳其字符 (DOS)

 

858

IBM00858

OEM 多语言拉丁语 I

 

860

IBM860

葡萄牙语 (DOS)

 

861

ibm861

冰岛语 (DOS)

 

862

DOS-862

希伯来字符 (DOS)

 

863

IBM863

加拿大法语 (DOS)

 

864

IBM864

阿拉伯字符 (864)

 

865

IBM865

北欧字符 (DOS)

 

866

cp866

西里尔字符 (DOS)

 

869

ibm869

现代希腊字符 (DOS)

 

870

IBM870

IBM EBCDIC(多语言拉丁语 2)

 

874

windows-874

泰语 (Windows)

 

875

cp875

IBM EBCDIC(现代希腊语)

 

932

shift_jis

日语 (Shift-JIS)

 

936

gb2312

简体中文 (GB2312)

*

949

ks_c_5601-1987

朝鲜语

 

950

big5

繁体中文 (Big5)

 

1026

IBM1026

IBM EBCDIC(土耳其拉丁语 5)

 

1047

IBM01047

IBM 拉丁语 1

 

1140

IBM01140

IBM EBCDIC(美国 - 加拿大 - 欧洲)

 

1141

IBM01141

IBM EBCDIC(德国 - 欧洲)

 

1142

IBM01142

IBM EBCDIC(丹麦 - 挪威 - 欧洲)

 

1143

IBM01143

IBM EBCDIC(芬兰 - 瑞典 - 欧洲)

 

1144

IBM01144

IBM EBCDIC(意大利 - 欧洲)

 

1145

IBM01145

IBM EBCDIC(西班牙 - 欧洲)

 

1146

IBM01146

IBM EBCDIC(英国 - 欧洲)

 

1147

IBM01147

IBM EBCDIC(法国 - 欧洲)

 

1148

IBM01148

IBM EBCDIC(国际 - 欧洲)

 

1149

IBM01149

IBM EBCDIC(冰岛语 - 欧洲)

 

1200

utf-16

Unicode

*

1201

unicodeFFFE

Unicode (Big-Endian)

*

1250

windows-1250

中欧字符 (Windows)

 

1251

windows-1251

西里尔字符 (Windows)

 

1252

Windows-1252

西欧字符 (Windows)

*

1253

windows-1253

希腊字符 (Windows)

 

1254

windows-1254

土耳其字符 (Windows)

 

1255

windows-1255

希伯来字符 (Windows)

 

1256

windows-1256

阿拉伯字符 (Windows)

 

1257

windows-1257

波罗的海字符 (Windows)

 

1258

windows-1258

越南字符 (Windows)

 

1361

Johab

朝鲜语 (Johab)

 

10000

macintosh

西欧字符 (Mac)

 

10001

x-mac-japanese

日语 (Mac)

 

10002

x-mac-chinesetrad

繁体中文 (Mac)

 

10003

x-mac-korean

朝鲜语 (Mac)

*

10004

x-mac-arabic

阿拉伯字符 (Mac)

 

10005

x-mac-hebrew

希伯来字符 (Mac)

 

10006

x-mac-greek

希腊字符 (Mac)

 

10007

x-mac-cyrillic

西里尔字符 (Mac)

 

10008

x-mac-chinesesimp

简体中文 (Mac)

*

10010

x-mac-romanian

罗马尼亚语 (Mac)

 

10017

x-mac-ukrainian

乌克兰语 (Mac)

 

10021

x-mac-thai

泰语 (Mac)

 

10029

x-mac-ce

中欧字符 (Mac)

 

10079

x-mac-icelandic

冰岛语 (Mac)

 

10081

x-mac-turkish

土耳其字符 (Mac)

 

10082

x-mac-croatian

克罗地亚语 (Mac)

 

12000

utf-32

Unicode (UTF-32)

*

12001

utf-32BE

Unicode (UTF-32 Big-Endian)

*

20000

x-Chinese-CNS

繁体中文 (CNS)

 

20001

x-cp20001

TCA 台湾

 

20002

x-Chinese-Eten

繁体中文 (Eten)

 

20003

x-cp20003

IBM5550 台湾

 

20004

x-cp20004

TeleText 台湾

 

20005

x-cp20005

Wang 台湾

 

20105

x-IA5

西欧字符 (IA5)

 

20106

x-IA5-German

德语 (IA5)

 

20107

x-IA5-Swedish

瑞典语 (IA5)

 

20108

x-IA5-Norwegian

挪威语 (IA5)

 

20127

us-ascii

US-ASCII

*

20261

x-cp20261

T.61

 

20269

x-cp20269

ISO-6937

 

20273

IBM273

IBM EBCDIC(德国)

 

20277

IBM277

IBM EBCDIC(丹麦 - 挪威)

 

20278

IBM278

IBM EBCDIC(芬兰 - 瑞典)

 

20280

IBM280

IBM EBCDIC(意大利)

 

20284

IBM284

IBM EBCDIC(西班牙)

 

20285

IBM285

IBM EBCDIC(英国)

 

20290

IBM290

IBM EBCDIC(日语片假名)

 

20297

IBM297

IBM EBCDIC(法国)

 

20420

IBM420

IBM EBCDIC(阿拉伯语)

 

20423

IBM423

IBM EBCDIC(希腊语)

 

20424

IBM424

IBM EBCDIC(希伯来语)

 

20833

x-EBCDIC-KoreanExtended

IBM EBCDIC(朝鲜语扩展)

 

20838

IBM-Thai

IBM EBCDIC(泰语)

 

20866

koi8-r

西里尔字符 (KOI8-R)

 

20871

IBM871

IBM EBCDIC(冰岛语)

 

20880

IBM880

IBM EBCDIC(西里尔俄语)

 

20905

IBM905

IBM EBCDIC(土耳其语)

 

20924

IBM00924

IBM 拉丁语 1

 

20932

EUC-JP

日语(JIS 0208-1990 和 0212-1990)

 

20936

x-cp20936

简体中文 (GB2312-80)

*

20949

x-cp20949

朝鲜语 Wansung

*

21025

cp1025

IBM EBCDIC(西里尔塞尔维亚 - 保加利亚语)

 

21866

koi8-u

西里尔字符 (KOI8-U)

 

28591

iso-8859-1

西欧字符 (ISO)

*

28592

iso-8859-2

中欧字符 (ISO)

 

28593

iso-8859-3

拉丁语 3 (ISO)

 

28594

iso-8859-4

波罗的海字符 (ISO)

 

28595

iso-8859-5

西里尔字符 (ISO)

 

28596

iso-8859-6

阿拉伯字符 (ISO)

 

28597

iso-8859-7

希腊字符 (ISO)

 

28598

iso-8859-8

希伯来字符 (ISO-Visual)

*

28599

iso-8859-9

土耳其字符 (ISO)

 

28603

iso-8859-13

爱沙尼亚语 (ISO)

 

28605

iso-8859-15

拉丁语 9 (ISO)

 

29001

x-Europa

欧罗巴

 

38598

iso-8859-8-i

希伯来字符 (ISO-Logical)

*

50220

iso-2022-jp

日语 (JIS)

*

50221

csISO2022JP

日语(JIS- 允许 1 字节假名)

*

50222

iso-2022-jp

日语(JIS- 允许 1 字节假名 - SO/SI)

*

50225

iso-2022-kr

朝鲜语 (ISO)

*

50227

x-cp50227

简体中文 (ISO-2022)

*

51932

euc-jp

日语 (EUC)

*

51936

EUC-CN

简体中文 (EUC)

*

51949

euc-kr

朝鲜语 (EUC)

*

52936

hz-gb-2312

简体中文 (HZ)

*

54936

GB18030

简体中文 (GB18030)

*

57002

x-iscii-de

ISCII 梵文

*

57003

x-iscii-be

ISCII 孟加拉语

*

57004

x-iscii-ta

ISCII 泰米尔语

*

57005

x-iscii-te

ISCII 泰卢固语

*

57006

x-iscii-as

ISCII 阿萨姆语

*

57007

x-iscii-or

ISCII 奥里雅语

*

57008

x-iscii-ka

ISCII 卡纳达语

*

57009

x-iscii-ma

ISCII 马拉雅拉姆字符

*

57010

x-iscii-gu

ISCII 古吉拉特字符

*

57011

x-iscii-pa

ISCII 旁遮普字符

*

65000

utf-7

Unicode (UTF-7)

*

65001

utf-8

Unicode (UTF-8)

*

Encoder。

例如,大写拉丁字母 A (U+0041) 的序列化结果(十六进制)如下所示:

  • UTF-16 Big-Endian 字节顺序:00 41

  • UTF-16 Little-Endian 字节顺序:41 00

  • UTF-32 Big-Endian 字节顺序:00 00 00 41

  • UTF-32 Little-Endian 字节顺序:41 00 00 00

例如,在 Little-endian 平台(如 Intel 计算机)上最好使用 Little-endian 字节顺序。

如果将此字节数组作为编码流的前缀,将有助于解码器识别所用的编码格式。

Unicode home page(Unicode 主页)上的“The Unicode Standard”(Unicode 标准)。

请注意,编码类允许错误进行如下更改:

  • 在不提示的情况下更改为“?”字符。

  • 使用“最佳匹配”字符。

  • DecoderFallback 类与 U+FFFD Unicode 替换字符结合使用来更改为特定于应用程序的行为。

对于 ANSI 编码,最佳匹配行为是默认行为。

示例


下面的示例将字符串从一种编码转换为另一种编码。
注意

GetChars 调用将数据再解码为 Unicode。

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);

      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?) 
 

相关文章: