Encoding 类

参考

定义

命名空间:: System.Text

程序集:: System.Text.Encoding.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示字符编码。

public ref class Encoding abstract

public ref class Encoding abstract : ICloneable

public abstract class Encoding

public abstract class Encoding : ICloneable

[System.Serializable]
public abstract class Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable

type Encoding = class

type Encoding = class
    interface ICloneable

[<System.Serializable>]
type Encoding = class

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Encoding = class
    interface ICloneable

Public MustInherit Class Encoding

Public MustInherit Class Encoding
Implements ICloneable

继承: Object
Encoding

派生: System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

属性: SerializableAttribute ComVisibleAttribute

实现: ICloneable

示例

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

注意

byte[]在此示例中，数组是包含编码数据的唯一类型。 .NET Char 和 String 类型本身就是 unicode，因此调用会将 GetChars 数据解码回 unicode。

using namespace System;
using namespace System::Text;

int 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.
   array<Byte>^unicodeBytes = unicode->GetBytes( unicodeString );
   
   // Perform the conversion from one encoding to the other.
   array<Byte>^asciiBytes = Encoding::Convert( unicode, ascii, unicodeBytes );
   
   // Convert the new Byte into[] a char and[] then into a string.
   array<Char>^asciiChars = gcnew array<Char>(ascii->GetCharCount( asciiBytes, 0, asciiBytes->Length ));
   ascii->GetChars( asciiBytes, 0, asciiBytes->Length, asciiChars, 0 );
   String^ asciiString = gcnew 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 (?)

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 (?)

Imports System.Text

Class Example
   Shared Sub Main()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As 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)
   End Sub
End Class
' 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 (?)

注解

编码是将一组 Unicode 字符转换为一个字节序列的过程。相反，解码是将编码字节序列转换为一组 Unicode 字符的过程。有关 Unicode 转换格式（UTFs）和支持的其他编码的信息 Encoding ，请参阅.net 中的字符编码。

请注意， Encoding 旨在对 Unicode 字符而不是任意二进制数据（如字节数组）进行操作。如果必须将任意二进制数据编码为文本，则应使用诸如 uuencode 这样的协议，该协议是由等方法实现的 Convert.ToBase64CharArray 。

.NET 提供类的以下实现 Encoding 来支持当前的 Unicode 编码和其他编码：

ASCIIEncoding将 Unicode 字符编码为单个7位 ASCII 字符。此编码仅支持 U + 0000 到 U + 007F 之间的字符值。代码页20127。还可通过 ASCII 属性获得。
UTF7Encoding使用 UTF-7 编码对 Unicode 字符进行编码。此编码支持所有 Unicode 字符值。代码页65000。还可通过 UTF7 属性获得。
UTF8Encoding使用 UTF-8 编码对 Unicode 字符进行编码。此编码支持所有 Unicode 字符值。代码页65001。还可通过 UTF8 属性获得。
UnicodeEncoding使用 UTF-16 编码对 Unicode 字符进行编码。支持 little endian 和大型 endian 字节顺序。还可通过 Unicode 属性和属性获取 BigEndianUnicode 。
UTF32Encoding使用 32 UTF-8 编码对 Unicode 字符进行编码。支持 little endian （代码页12000）和大型 endian （代码页12001）字节顺序。还可通过 UTF32 属性获得。

Encoding类主要用于在不同的编码和 Unicode 之间转换。通常，其中一个派生的 Unicode 类是适用于你的应用程序的正确选择。

使用 GetEncoding 方法可获取其他编码，并调用 GetEncodings 方法来获取所有编码的列表。

编码列表

下表列出了 .NET 支持的编码。它列出了每个编码的代码页编号以及编码的 EncodingInfo.Name 和属性的值 EncodingInfo.DisplayName 。 .NET Framework支持、.NET Core 支持或 .NET 5 及更高版本支持列中的检查标记指示该 .NET 实现本机支持代码页，而不考虑基础平台。对于 .NET Framework，表中列出的其他编码的可用性取决于操作系统。对于 .NET Core 和 .NET 5 及更高版本，可以使用 System.Text.CodePagesEncodingProvider 类或派生自 System.Text.EncodingProvider 类的其他编码。

注意

EncodingInfo.Name属性对应于国际标准的代码页不一定完全符合该标准。

代码页	“属性”	显示名称	.NET Framework 支持	.NET Core 支持	.NET 5 及更高版本支持
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 （大字节序）	✓	✓	✓
1250	windows-1250	中欧语（Windows）
1251	windows-1251	西里尔语（Windows）
1252	GB2312	西欧(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-日语	日语（Mac）
10002	x-mac-chinesetrad	繁体中文（Mac）
10003	x-mac-韩语	朝鲜语(Mac)	✓
10004	x-mac-阿拉伯语	阿拉伯语（Mac）
10005	x-mac-希伯来语	希伯来语（Mac）
10006	x-mac-希腊语	希腊语（Mac）
10007	x-mac-西里尔文	西里尔语（Mac）
10008	x-mac-chinesesimp	简体中文(Mac)	✓
10010	x-mac	罗马尼亚语（Mac）
10017	x-mac-乌克兰语	乌克兰语（Mac）
10021	x-mac-泰语	泰语（Mac）
10029	x-mac-ce	中欧语（Mac）
10079	x-mac-冰岛语	冰岛语（Mac）
10081	x-mac-土耳其语	土耳其语（Mac）
10082	x-mac-克罗地亚语	克罗地亚语（Mac）
12000	utf-32	Unicode （UTF-32）	✓	✓	✓
12001	32BE	Unicode （UTF-16 32 大字节序）	✓	✓	✓
20000	x-中文-CNS	繁体中文（CNS）
20001	x-cp20001	TCA 台湾
20002	x-中文-Eten	繁体中文（Eten）
20003	x-cp20003	IBM5550 台湾
20004	x-cp20004	TeleText 台湾
20005	x-cp20005	Wang 台湾
20105	x-IA5	西欧（IA5）
20106	x-IA5-德语	德语（IA5）
20107	x IA5-瑞典语	瑞典语（IA5）
20108	x IA5-挪威语	挪威语（IA5）
20127	us-ascii	US-ASCII	✓	✓	✓
20261	x-cp20261	不是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-泰语	IBM EBCDIC （泰语）
20866	koi8-ru-r	西里尔语（KOI8-RU-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-ru-u	西里尔语（KOI8-RU）
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-欧洲	欧洲
38598	iso-8859-8-i	希伯来语（ISO-逻辑）	✓
50220	iso-2022-日本	日语(JIS)	✓
50221	csISO2022JP	日语（JIS-允许1字节假名）	✓
50222	iso-2022-日本	日语（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	ISCII 孟加拉语	✓
57004	x-iscii-ta	ISCII 泰米尔语	✓
57005	x-iscii-te	ISCII 泰卢固语	✓
57006	x-iscii-as	ISCII 阿萨姆语	✓
57007	x-iscii-或	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)	✓	✓	✓

下面的示例调用 GetEncoding(Int32) 和 GetEncoding(String) 方法以获取希腊语（Windows）代码页编码。它将 Encoding 方法调用返回的对象进行比较，以显示它们相等，然后 maps 显示每个字符在希腊语字母表中的 Unicode 码位和相应的代码页值。

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding enc = Encoding.GetEncoding(1253);
      Encoding altEnc = Encoding.GetEncoding("windows-1253");
      Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
                        altEnc.CodePage, enc.Equals(altEnc));
      string greekAlphabet = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
                             "Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
                             "Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
                             "Φ φ Χ χ Ψ ψ Ω ω";
      Console.OutputEncoding = Encoding.UTF8;
      byte[] bytes = enc.GetBytes(greekAlphabet);
      Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
                        "Unicode Code Point", "Code Page 1253");
      for (int ctr = 0; ctr < bytes.Length; ctr++) {
         if (greekAlphabet[ctr].Equals(' '))
            continue;

         Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet[ctr],
                           GetCodePoint(greekAlphabet[ctr]), bytes[ctr]);
      }
   }

   private static string GetCodePoint(char ch)
   {
      string retVal = "u+";
      byte[] bytes = Encoding.Unicode.GetBytes(ch.ToString());
      for (int ctr = bytes.Length - 1; ctr >= 0; ctr--)
         retVal += bytes[ctr].ToString("X2");

      return retVal;
   }
}
// The example displays the following output:
//       Character      Unicode Code Point       Code Page 1253
//       Α                          u+0391                   C1
//       α                          u+03B1                   E1
//       Β                          u+0392                   C2
//       β                          u+03B2                   E2
//       Γ                          u+0393                   C3
//       γ                          u+03B3                   E3
//       Δ                          u+0394                   C4
//       δ                          u+03B4                   E4
//       Ε                          u+0395                   C5
//       ε                          u+03B5                   E5
//       Ζ                          u+0396                   C6
//       ζ                          u+03B6                   E6
//       Η                          u+0397                   C7
//       η                          u+03B7                   E7
//       Θ                          u+0398                   C8
//       θ                          u+03B8                   E8
//       Ι                          u+0399                   C9
//       ι                          u+03B9                   E9
//       Κ                          u+039A                   CA
//       κ                          u+03BA                   EA
//       Λ                          u+039B                   CB
//       λ                          u+03BB                   EB
//       Μ                          u+039C                   CC
//       μ                          u+03BC                   EC
//       Ν                          u+039D                   CD
//       ν                          u+03BD                   ED
//       Ξ                          u+039E                   CE
//       ξ                          u+03BE                   EE
//       Ο                          u+039F                   CF
//       ο                          u+03BF                   EF
//       Π                          u+03A0                   D0
//       π                          u+03C0                   F0
//       Ρ                          u+03A1                   D1
//       ρ                          u+03C1                   F1
//       Σ                          u+03A3                   D3
//       σ                          u+03C3                   F3
//       ς                          u+03C2                   F2
//       Τ                          u+03A4                   D4
//       τ                          u+03C4                   F4
//       Υ                          u+03A5                   D5
//       υ                          u+03C5                   F5
//       Φ                          u+03A6                   D6
//       φ                          u+03C6                   F6
//       Χ                          u+03A7                   D7
//       χ                          u+03C7                   F7
//       Ψ                          u+03A8                   D8
//       ψ                          u+03C8                   F8
//       Ω                          u+03A9                   D9
//       ω                          u+03C9                   F9

Imports System.Text

Module Example
   Public Sub Main()
      Dim enc As Encoding = Encoding.GetEncoding(1253)
      Dim altEnc As Encoding = Encoding.GetEncoding("windows-1253")
      Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
                        altEnc.CodePage, enc.Equals(altEnc))
      Dim greekAlphabet As String = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
                                    "Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
                                    "Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
                                    "Φ φ Χ χ Ψ ψ Ω ω"
      Console.OutputEncoding = Encoding.UTF8
      Dim bytes() As Byte = enc.GetBytes(greekAlphabet)
      Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
                        "Unicode Code Point", "Code Page 1253")
      For ctr As Integer = 0 To bytes.Length - 1
         If greekAlphabet(ctr).Equals(" "c) Then Continue For

         Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet(ctr),
                           GetCodePoint(greekAlphabet(ctr)), bytes(ctr))
      Next

   End Sub
   
   Private Function GetCodePoint(ch As String) As String
      Dim retVal As String = "u+"
      Dim bytes() As Byte = Encoding.Unicode.GetBytes(ch)
      For ctr As Integer = bytes.Length - 1 To 0 Step -1
         retVal += bytes(ctr).ToString("X2")
      Next
      Return retVal
   End Function
End Module
' The example displays the following output:
'    Character      Unicode Code Point       Code Page 1253
'    Α                          u+0391                   C1
'    α                          u+03B1                   E1
'    Β                          u+0392                   C2
'    β                          u+03B2                   E2
'    Γ                          u+0393                   C3
'    γ                          u+03B3                   E3
'    Δ                          u+0394                   C4
'    δ                          u+03B4                   E4
'    Ε                          u+0395                   C5
'    ε                          u+03B5                   E5
'    Ζ                          u+0396                   C6
'    ζ                          u+03B6                   E6
'    Η                          u+0397                   C7
'    η                          u+03B7                   E7
'    Θ                          u+0398                   C8
'    θ                          u+03B8                   E8
'    Ι                          u+0399                   C9
'    ι                          u+03B9                   E9
'    Κ                          u+039A                   CA
'    κ                          u+03BA                   EA
'    Λ                          u+039B                   CB
'    λ                          u+03BB                   EB
'    Μ                          u+039C                   CC
'    μ                          u+03BC                   EC
'    Ν                          u+039D                   CD
'    ν                          u+03BD                   ED
'    Ξ                          u+039E                   CE
'    ξ                          u+03BE                   EE
'    Ο                          u+039F                   CF
'    ο                          u+03BF                   EF
'    Π                          u+03A0                   D0
'    π                          u+03C0                   F0
'    Ρ                          u+03A1                   D1
'    ρ                          u+03C1                   F1
'    Σ                          u+03A3                   D3
'    σ                          u+03C3                   F3
'    ς                          u+03C2                   F2
'    Τ                          u+03A4                   D4
'    τ                          u+03C4                   F4
'    Υ                          u+03A5                   D5
'    υ                          u+03C5                   F5
'    Φ                          u+03A6                   D6
'    φ                          u+03C6                   F6
'    Χ                          u+03A7                   D7
'    χ                          u+03C7                   F7
'    Ψ                          u+03A8                   D8
'    ψ                          u+03C8                   F8
'    Ω                          u+03A9                   D9
'    ω                          u+03C9                   F9

如果要转换的数据仅在顺序块（如从流中读取的数据）中可用，或者如果数据量很大以致需要分为更小块，则应使用 Decoder Encoder GetDecoder 派生类的方法或方法提供的或 GetEncoder 。

UTF-16 和32编码器可以使用大 endian 字节顺序（首先是最重要的字节），也可以是 little endian 字节顺序（首先是最不重要的字节）。例如，拉丁文大写字母 A （U + 0041）按以下方式序列化（十六进制）：

UTF-16 大 endian 字节顺序： 00 41
UTF-16 little endian 字节顺序： 41 00
32大 endian 字节顺序： 00 00 00 41
32 little endian 字节顺序： 41 00 00 00

使用本机字节顺序存储 Unicode 字符通常更有效。例如，最好使用 little endian 平台（如 Intel 计算机）上的 little endian 字节顺序。

GetPreamble方法检索包含字节顺序标记（BOM）的字节数组。如果此字节数组的前缀为编码的流，则它有助于解码器识别所使用的编码格式。

有关字节顺序和字节顺序标记的详细信息，请参阅unicode 主页上的 unicode 标准。

请注意，编码类允许错误：

以无提示方式更改为 "？" 字符。
使用 "最佳匹配" 字符。
通过将 EncoderFallback 和 DecoderFallback 类与 U + FFFD Unicode 替换字符一起使用，更改为应用程序特定的行为。

应在出现任何数据流错误时引发异常。应用在适用或使用和类时，使用 "throwonerror" 标志 EncoderExceptionFallback DecoderExceptionFallback 。通常不建议使用最佳回退，因为这可能会导致数据丢失或混乱，并比简单字符替换慢。对于 ANSI 编码，最佳行为是默认值。

构造函数

Encoding()	初始化 Encoding 类的新实例。
Encoding(Int32)	初始化对应于指定代码页的 Encoding 类的新实例。
Encoding(Int32, EncoderFallback, DecoderFallback)	使用指定编码器和解码器回退策略初始化对应于指定代码页的 Encoding 类的新实例。

属性

ASCII	获取 ASCII（7 位）字符集的编码。
BigEndianUnicode	获取使用 Big Endian 字节顺序的 UTF-16 格式的编码。
BodyName	在派生类中重写时，获取可与邮件代理正文标记一起使用的当前编码的名称。
CodePage	在派生类中重写时，获取当前 Encoding 的代码页标识符。
DecoderFallback	获取或设置当前 DecoderFallback 对象的 Encoding 对象。
Default	获取此 .NET 实现的默认编码。
EncoderFallback	获取或设置当前 EncoderFallback 对象的 Encoding 对象。
EncodingName	在派生类中重写时，获取当前编码的用户可读说明。
HeaderName	在派生类中重写时，获取可与邮件代理头标记一起使用的当前编码的名称。
IsBrowserDisplay	在派生类中重写时，获取一个值，该值指示浏览器客户端是否可以使用当前的编码显示内容。
IsBrowserSave	在派生类中重写时，获取一个值，该值指示浏览器客户端是否可以使用当前的编码保存内容。
IsMailNewsDisplay	在派生类中重写时，获取一个值，该值指示邮件和新闻客户端是否可以使用当前的编码显示内容。
IsMailNewsSave	在派生类中重写时，获取一个值，该值指示邮件和新闻客户端是否可以使用当前的编码保存内容。
IsReadOnly	在派生类中重写时，获取一个值，该值指示当前的编码是否为只读。
IsSingleByte	在派生类中重写时，获取一个值，该值指示当前的编码是否使用单字节码位。
Latin1	获取 Latin1 字符集 (ISO-8859-1) 的编码。
Preamble	在派生类中重写时，返回包含指定所用编码的字节序列的范围。
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)	将字节数组内某个范围的字节从一种编码转换为另一种编码。
CreateTranscodingStream(Stream, Encoding, Encoding, Boolean)	创建一个 Stream，用于在内部 Encoding 和外部 Encoding 之间进行数据转码，类似于 Convert(Encoding, Encoding, Byte[])。
Equals(Object)	确定指定的 Object 是否等同于当前实例。
GetByteCount(Char*, Int32)	在派生类中重写时，计算对一组字符（从指定的字符指针处开始）进行编码所产生的字节数。
GetByteCount(Char[])	在派生类中重写时，计算对指定字符数组中的所有字符进行编码所产生的字节数。
GetByteCount(Char[], Int32, Int32)	在派生类中重写时，计算对指定字符数组中的一组字符进行编码所产生的字节数。
GetByteCount(ReadOnlySpan<Char>)	在派生类中重写时，计算对指定字符范围的字符进行编码所产生的字节数。
GetByteCount(String)	在派生类中重写时，计算对指定字符串中的字符进行编码所产生的字节数。
GetByteCount(String, Int32, Int32)	在派生类中重写时，计算对指定字符串中的一组字符进行编码所产生的字节数。
GetBytes(Char, Int32, Byte, Int32)	在派生类中重写时，将一组字符（从指定的字符指针开始）编码为一个字节序列，并从指定的字节指针开始存储该字节序列。
GetBytes(Char[])	在派生类中重写时，将指定字符数组中的所有字符编码为一个字节序列。
GetBytes(Char[], Int32, Int32)	在派生类中重写时，将指定字符数组中的一组字符编码为一个字节序列。
GetBytes(Char[], Int32, Int32, Byte[], Int32)	在派生类中重写时，将指定字符数组中的一组字符编码为指定的字节数组。
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	在派生类中重写时，将指定只读范围中的一组字符编码为字节范围。
GetBytes(String)	在派生类中重写时，将指定字符串中的所有字符编码为一个字节序列。
GetBytes(String, Int32, Int32)	在派生类中重写时，从指定的 `index` 开始，将指定字符串中由 `count` 指定的字符数编码为字节数组。
GetBytes(String, Int32, Int32, Byte[], Int32)	在派生类中重写时，将指定字符串中的一组字符编码为指定的字节数组。
GetCharCount(Byte*, Int32)	在派生类中重写时，计算对字节序列（从指定的字节指针开始）进行解码所产生的字符数。
GetCharCount(Byte[])	在派生类中重写时，计算对指定字节数组中的所有字节进行解码所产生的字符数。
GetCharCount(Byte[], Int32, Int32)	在派生类中重写时，计算对字节序列（从指定字节数组开始）进行解码所产生的字符数。
GetCharCount(ReadOnlySpan<Byte>)	在派生类中重写时，计算对提供的只读字节范围进行解码所产生的字符数。
GetChars(Byte, Int32, Char, Int32)	在派生类中重写时，将一个字节序列（从指定的字节指针开始）解码为一组字符，并从指定的字符指针开始存储该组字符。
GetChars(Byte[])	在派生类中重写时，将指定字节数组中的所有字节解码为一组字符。
GetChars(Byte[], Int32, Int32)	在派生类中重写时，将指定字节数组中的一个字节序列解码为一组字符。
GetChars(Byte[], Int32, Int32, Char[], Int32)	在派生类中重写时，将指定字节数组中的字节序列解码为指定的字符数组。
GetChars(ReadOnlySpan<Byte>, Span<Char>)	在派生类中重写时，将指定只读字节范围中的所有字节解码为字符范围。
GetDecoder()	在派生类中重写时，获取一个解码器，该解码器将已编码的字节序列转换为字符序列。
GetEncoder()	在派生类中重写时，获取一个解码器，该解码器将 Unicode 字符序列转换为已编码的字节序列。
GetEncoding(Int32)	返回与指定代码页标识符关联的编码。
GetEncoding(Int32, EncoderFallback, DecoderFallback)	返回与指定代码页标识符关联的编码。参数指定一个错误处理程序，用于处理无法编码的字符和无法解码的字节序列。
GetEncoding(String)	返回与指定代码页名称关联的编码。
GetEncoding(String, EncoderFallback, DecoderFallback)	返回与指定代码页名称关联的编码。参数指定一个错误处理程序，用于处理无法编码的字符和无法解码的字节序列。
GetEncodings()	返回包含所有编码的数组。
GetHashCode()	返回当前实例的哈希代码。
GetMaxByteCount(Int32)	在派生类中重写时，计算对指定数目的字符进行编码所产生的最大字节数。
GetMaxCharCount(Int32)	在派生类中重写时，计算对指定数目的字节进行解码时所产生的最大字符数。
GetPreamble()	在派生类中重写时，返回指定所用编码的字节序列。
GetString(Byte*, Int32)	在派生类中重写时，将在指定地址开始的指定字节数解码为字符串。
GetString(Byte[])	在派生类中重写时，将指定字节数组中的所有字节解码为一个字符串。
GetString(Byte[], Int32, Int32)	在派生类中重写时，将指定字节数组中的一个字节序列解码为一个字符串。
GetString(ReadOnlySpan<Byte>)	在派生类中重写时，将指定字节范围中的所有字节解码为一个字符串。
GetType()	获取当前实例的 Type。 (继承自 Object)
IsAlwaysNormalized()	使用默认范式获取一个值，该值指示当前编码是否始终被规范化。
IsAlwaysNormalized(NormalizationForm)	在派生类中重写时，使用指定范式获取一个值，该值指示当前编码是否始终被规范化。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
RegisterProvider(EncodingProvider)	注册编码提供程序。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	如果目标足够大，则从指定的只读范围将一组字符编码为字节范围。
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	如果目标足够大，则从指定的只读范围解码为字符范围中的一组字节。

扩展方法

GetBytes(Encoding, ReadOnlySequence<Char>)	使用指定的 Encoding 将指定的 ReadOnlySequence<T> 编码到 Byte 数组中。
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	使用指定的 Encoding 将指定的 ReadOnlySequence<T> 解码为 `byte`，并将结果写入 `writer`。
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	使用指定的 Encoding 将指定的 ReadOnlySequence<T> 编码为 `byte`，并将结果输出到 `bytes`。
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	使用指定的 Encoding 将指定的 ReadOnlySpan<T> 编码为 `byte`，并将结果写入 `writer`。
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	使用指定的 Encoding 将指定的 ReadOnlySequence<T> 解码为 `char`，并将结果写入 `writer`。
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	使用指定的 Encoding 将指定的 ReadOnlySequence<T> 解码为 `char`，并将结果输出到 `chars`。
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	使用指定的 Encoding 将指定的 ReadOnlySpan<T> 解码为 `char`，并将结果写入 `writer`。
GetString(Encoding, ReadOnlySequence<Byte>)	使用指定的 Encoding 将指定的 ReadOnlySequence<T> 解码到 String。

适用于

另请参阅

如何在 .NET 中使用字符编码类

Encoding 类

定义

示例

注解

编码列表

构造函数

属性

方法

扩展方法

适用于

另请参阅

其他资源