Encoding 类

定义

表示字符编码。

public ref class Encoding abstract
public ref class Encoding abstract : ICloneable
public abstract class Encoding
[System.Serializable]
public abstract class Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable
public abstract class Encoding : ICloneable
type Encoding = class
[<System.Serializable>]
type Encoding = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Encoding = class
    interface ICloneable
type Encoding = class
    interface ICloneable
Public MustInherit Class Encoding
Public MustInherit Class Encoding
Implements ICloneable
继承
Encoding
派生
属性
实现

示例

以下示例将字符串从一个编码转换为另一个编码。

注释

byte[] 数组是此示例中唯一包含编码数据的类型。 .NET CharString 类型本身为 Unicode,因此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 (?)
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 (?)

注解

有关此 API 的详细信息,请参阅 编码的补充 API 备注

构造函数

名称 说明
Encoding()

初始化 Encoding 类的新实例。

Encoding(Int32, EncoderFallback, DecoderFallback)

使用指定的编码器和解码器回退策略初始化与指定代码页对应的类的新实例 Encoding

Encoding(Int32)

初始化与指定代码页对应的类的新实例 Encoding

属性

名称 说明
ASCII

获取 ASCII(7 位)字符集的编码。

BigEndianUnicode

获取使用大字节字节顺序的 UTF-16 格式的编码。

BodyName

在派生类中重写时,获取可用于邮件代理正文标记的当前编码的名称。

CodePage

在派生类中重写时,获取当前 Encoding代码页标识符。

DecoderFallback

获取或设置 DecoderFallback 当前 Encoding 对象的对象。

Default

获取此 .NET 实现的默认编码。

EncoderFallback

获取或设置 EncoderFallback 当前 Encoding 对象的对象。

EncodingName

在派生类中重写时,获取当前编码的人类可读说明。

HeaderName

在派生类中重写时,获取可用于邮件代理标头标记的当前编码的名称。

IsBrowserDisplay

在派生类中重写时,获取一个值,该值指示浏览器客户端是否可以使用当前编码来显示内容。

IsBrowserSave

在派生类中重写时,获取一个值,该值指示浏览器客户端是否可以使用当前编码来保存内容。

IsMailNewsDisplay

在派生类中重写时,获取一个值,该值指示邮件和新闻客户端是否可以使用当前编码来显示内容。

IsMailNewsSave

在派生类中重写时,获取一个值,该值指示邮件和新闻客户端是否可以使用当前编码来保存内容。

IsReadOnly

在派生类中重写时,获取一个值,该值指示当前编码是否为只读。

IsSingleByte

在派生类中重写时,获取一个值,该值指示当前编码是否使用单字节码位。

Preamble

在派生类中重写时,返回包含指定所用编码的字节序列的范围。

Unicode

使用小字节顺序获取 UTF-16 格式的编码。

UTF32

使用小字节顺序获取 UTF-32 格式的编码。

UTF7

获取 UTF-7 格式的编码。

UTF8

获取 UTF-8 格式的编码。

WebName

在派生类中重写时,获取为当前编码向 Internet 分配号码颁发机构(IANA)注册的名称。

WindowsCodePage

在派生类中重写时,获取与当前编码最接近的 Windows 操作系统代码页。

方法

名称 说明
Clone()

在派生类中重写时,创建当前 Encoding 对象的浅表副本。

Convert(Encoding, Encoding, Byte[], Int32, Int32)

将字节数组中的字节范围从一个编码转换为另一个编码。

Convert(Encoding, Encoding, Byte[])

将整个字节数组从一个编码转换为另一个编码。

Equals(Object)

确定指定的 Object 实例是否等于当前实例。

GetByteCount(Char[], Int32, Int32)

在派生类中重写时,计算通过编码指定字符数组中的一组字符生成的字节数。

GetByteCount(Char[])

在派生类中重写时,计算通过编码指定字符数组中的所有字符生成的字节数。

GetByteCount(Char*, Int32)

在派生类中重写时,计算通过编码一组字符(从指定字符指针开始)生成的字节数。

GetByteCount(ReadOnlySpan<Char>)

在派生类中重写时,计算通过对指定字符范围中的字符进行编码生成的字节数。

GetByteCount(String, Int32, Int32)

在派生类中重写时,计算通过对指定字符串中的一组字符进行编码生成的字节数。

GetByteCount(String)

在派生类中重写时,计算通过对指定字符串中的字符进行编码生成的字节数。

GetBytes(Char[], Int32, Int32, Byte[], Int32)

在派生类中重写时,将指定字符数组中的一组字符编码为指定的字节数组。

GetBytes(Char[], Int32, Int32)

在派生类中重写时,将指定字符数组中的一组字符编码为字节序列。

GetBytes(Char[])

在派生类中重写时,将指定字符数组中的所有字符编码为字节序列。

GetBytes(Char*, Int32, Byte*, Int32)

在派生类中重写时,将一组从指定字符指针开始的字符编码为从指定字节指针开始存储的字节序列。

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

在派生类中重写时,将字节范围编码为指定只读范围中的一组字符。

GetBytes(String, Int32, Int32, Byte[], Int32)

在派生类中重写时,将指定字符串中的一组字符编码为指定的字节数组。

GetBytes(String, Int32, Int32)

在派生类中重写时,从指定的count字符串开始,编码为由指定字符串中指定的index字符数的字节数组。

GetBytes(String)

在派生类中重写时,将指定字符串中的所有字符编码为字节序列。

GetCharCount(Byte[], Int32, Int32)

在派生类中重写时,计算通过解码指定字节数组中的字节序列生成的字符数。

GetCharCount(Byte[])

在派生类中重写时,计算通过解码指定字节数组中的所有字节生成的字符数。

GetCharCount(Byte*, Int32)

在派生类中重写时,计算解码从指定字节指针开始的字节序列生成的字符数。

GetCharCount(ReadOnlySpan<Byte>)

在派生类中重写时,计算通过解码提供的只读字节范围生成的字符数。

GetChars(Byte[], Int32, Int32, Char[], Int32)

在派生类中重写时,将指定字节数组中的字节序列解码为指定的字符数组。

GetChars(Byte[], Int32, Int32)

在派生类中重写时,将指定字节数组中的字节序列解码为一组字符。

GetChars(Byte[])

在派生类中重写时,将指定字节数组中的所有字节解码为一组字符。

GetChars(Byte*, Int32, Char*, Int32)

在派生类中重写时,将从指定字节指针开始的字节序列解码为从指定字符指针开始存储的一组字符。

GetChars(ReadOnlySpan<Byte>, Span<Char>)

在派生类中重写时,将指定只读字节范围中的所有字节解码为字符范围。

GetDecoder()

在派生类中重写时,获取将编码字节序列转换为字符序列的解码器。

GetEncoder()

在派生类中重写时,获取将 Unicode 字符序列转换为编码字节序列的编码器。

GetEncoding(Int32, EncoderFallback, DecoderFallback)

返回与指定代码页标识符关联的编码。 参数为无法编码的字符和无法解码的字节序列指定错误处理程序。

GetEncoding(Int32)

返回与指定代码页标识符关联的编码。

GetEncoding(String, EncoderFallback, DecoderFallback)

返回与指定代码页名称关联的编码。 参数为无法编码的字符和无法解码的字节序列指定错误处理程序。

GetEncoding(String)

返回与指定代码页名称关联的编码。

GetEncodings()

返回包含所有编码的数组。

GetHashCode()

返回当前实例的哈希代码。

GetMaxByteCount(Int32)

在派生类中重写时,计算通过编码指定字符数生成的最大字节数。

GetMaxCharCount(Int32)

在派生类中重写时,计算通过解码指定字节数生成的最大字符数。

GetPreamble()

在派生类中重写时,返回指定使用的编码的字节序列。

GetString(Byte[], Int32, Int32)

在派生类中重写时,将指定字节数组中的字节序列解码为字符串。

GetString(Byte[])

在派生类中重写时,将指定字节数组中的所有字节解码为字符串。

GetString(Byte*, Int32)

在派生类中重写时,将从指定地址开始的指定字节数解码为字符串。

GetString(ReadOnlySpan<Byte>)

在派生类中重写时,将指定字节范围中的所有字节解码为字符串。

GetType()

获取当前实例的 Type

(继承自 Object)
IsAlwaysNormalized()

获取一个值,该值指示当前编码是否始终使用默认规范化形式进行规范化。

IsAlwaysNormalized(NormalizationForm)

在派生类中重写时,获取一个值,该值指示当前编码是否始终使用指定的规范化形式进行规范化。

MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
RegisterProvider(EncodingProvider)

注册编码提供程序。

ToString()

返回一个表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅