UTF7Encoding 类

定义

命名空间:

System.Text

程序集:

System.Text.Encoding.Extensions.dll

Source:

UTF7Encoding.cs

表示 Unicode 字符的 UTF-7 编码。

public ref class UTF7Encoding : System::Text::Encoding

public class UTF7Encoding : System.Text.Encoding

type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

继承

Object

Encoding

UTF7Encoding

示例

下面的代码示例演示如何使用 UTF7Encoding 对 Unicode 字符的字符串进行编码，并将其存储在字节数组中。 请注意，当字节数组解码回字符串时，不会丢失任何数据。

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   
   // Create a UTF-7 encoding.
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   
   // A Unicode string with two characters outside a 7-bit code range.
   String^ unicodeString = L"This Unicode string contains two characters with codes outside a 7-bit code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original string:" );
   Console::WriteLine( unicodeString );
   
   // Encode the string.
   array<Byte>^encodedBytes = utf7->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
   
   // Decode bytes back to string.
   // Notice Pi and Sigma characters are still present.
   String^ decodedString = utf7->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Create a UTF-7 encoding.
        UTF7Encoding utf7 = new UTF7Encoding();
        
        // A Unicode string with two characters outside a 7-bit code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside a 7-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf7.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = utf7.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        ' Create a UTF-7 encoding.
        Dim utf7 As New UTF7Encoding()
        
        ' A Unicode string with two characters outside a 7-bit code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside a 7-bit code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = utf7.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = utf7.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

注解

编码是将一组 Unicode 字符转换为一个字节序列的过程。 解码是将编码字节序列转换为一组 Unicode 字符的过程。

UTF-7 编码将 Unicode 字符表示为 7 位 ASCII 字符序列。 此编码支持某些需要它的协议，最常见的是电子邮件或新闻组协议。 由于 UTF-7 不是特别安全或可靠，并且大多数新式系统允许 8 位编码，因此 UTF-8 通常应优先于 UTF-7。

注意

UTF7Encoding 不提供错误检测。 出于安全原因，应用程序应使用 UTF8Encoding、 UnicodeEncoding或 UTF32Encoding 并启用错误检测。

有关 UTF 和支持System.Text的其他编码的详细信息，请参阅 .NET Framework 中的字符编码。

GetByteCount方法确定导致对一组 Unicode 字符进行编码的字节数， GetBytes 方法执行实际编码。

同样， GetCharCount 方法确定导致解码字节序列的字符数，和 GetCharsGetString 方法执行实际解码。

UTF7Encoding 对应于 Windows 代码页 65000。

注意

如果使用不同的.NET Framework版本序列化和反序列化 UTF-7 编码对象，则不会保留该对象的状态。

构造函数

UTF7Encoding()	已过时. 初始化 UTF7Encoding 类的新实例。
UTF7Encoding(Boolean)	已过时. 初始化 UTF7Encoding 类的新实例。 一个参数指定是否允许可选字符。

属性

BodyName	在派生类中重写时，获取可与邮件代理正文标记一起使用的当前编码的名称。 (继承自 Encoding)
CodePage	在派生类中重写时，获取当前 Encoding 的代码页标识符。 (继承自 Encoding)
DecoderFallback	获取或设置当前 DecoderFallback 对象的 Encoding 对象。 (继承自 Encoding)
EncoderFallback	获取或设置当前 EncoderFallback 对象的 Encoding 对象。 (继承自 Encoding)
EncodingName	在派生类中重写时，获取当前编码的用户可读说明。 (继承自 Encoding)
HeaderName	在派生类中重写时，获取可与邮件代理头标记一起使用的当前编码的名称。 (继承自 Encoding)
IsBrowserDisplay	在派生类中重写时，获取一个值，该值指示浏览器客户端是否可以使用当前的编码显示内容。 (继承自 Encoding)
IsBrowserSave	在派生类中重写时，获取一个值，该值指示浏览器客户端是否可以使用当前的编码保存内容。 (继承自 Encoding)
IsMailNewsDisplay	在派生类中重写时，获取一个值，该值指示邮件和新闻客户端是否可以使用当前的编码显示内容。 (继承自 Encoding)
IsMailNewsSave	在派生类中重写时，获取一个值，该值指示邮件和新闻客户端是否可以使用当前的编码保存内容。 (继承自 Encoding)
IsReadOnly	在派生类中重写时，获取一个值，该值指示当前的编码是否为只读。 (继承自 Encoding)
IsSingleByte	在派生类中重写时，获取一个值，该值指示当前的编码是否使用单字节码位。 (继承自 Encoding)
Preamble	在派生类中重写时，返回包含指定所用编码的字节序列的范围。 (继承自 Encoding)
WebName	在派生类中重写时，获取在 Internet 编号分配管理机构 (IANA) 注册的当前编码的名称。 (继承自 Encoding)
WindowsCodePage	在派生类中重写时，获取与当前编码最紧密对应的 Windows 操作系统代码页。 (继承自 Encoding)

方法

Clone()	当在派生类中重写时，创建当前 Encoding 对象的一个卷影副本。 (继承自 Encoding)
Equals(Object)	获取一个值，该值指示指定的对象是否等于当前的 UTF7Encoding 对象。
GetByteCount(Char*, Int32)	计算对从指定的字符指针开始的一组字符进行编码时产生的字节数。
GetByteCount(Char[])	在派生类中重写时，计算对指定字符数组中的所有字符进行编码所产生的字节数。 (继承自 Encoding)
GetByteCount(Char[], Int32, Int32)	计算对指定字符数组中的一组字符进行编码时产生的字节数。
GetByteCount(ReadOnlySpan<Char>)	在派生类中重写时，计算对指定字符范围的字符进行编码所产生的字节数。 (继承自 Encoding)
GetByteCount(String)	计算对指定 String 对象中的字符进行编码时产生的字节数。
GetByteCount(String, Int32, Int32)	在派生类中重写时，计算对指定字符串中的一组字符进行编码所产生的字节数。 (继承自 Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	将从指定的字符指针开始的一组字符编码为一个字节序列，并从指定的字节指针开始存储该字节序列。
GetBytes(Char[])	在派生类中重写时，将指定字符数组中的所有字符编码为一个字节序列。 (继承自 Encoding)
GetBytes(Char[], Int32, Int32)	在派生类中重写时，将指定字符数组中的一组字符编码为一个字节序列。 (继承自 Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	将指定字符数组中的一组字符编码到指定的字节数组中。
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	在派生类中重写时，将指定只读范围中的一组字符编码为字节范围。 (继承自 Encoding)
GetBytes(String)	在派生类中重写时，将指定字符串中的所有字符编码为一个字节序列。 (继承自 Encoding)
GetBytes(String, Int32, Int32)	在派生类中重写时，从指定的 index 开始，将指定字符串中由 count 指定的字符数编码为字节数组。 (继承自 Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	将指定 String 中的一组字符编码到指定的字节数组中。
GetCharCount(Byte*, Int32)	计算对一个字节序列（从指定的字节指针开始）进行解码所产生的字符数。
GetCharCount(Byte[])	在派生类中重写时，计算对指定字节数组中的所有字节进行解码所产生的字符数。 (继承自 Encoding)
GetCharCount(Byte[], Int32, Int32)	计算对指定字节数组中的一个字节序列进行解码所产生的字符数。
GetCharCount(ReadOnlySpan<Byte>)	在派生类中重写时，计算对提供的只读字节范围进行解码所产生的字符数。 (继承自 Encoding)
GetChars(Byte*, Int32, Char*, Int32)	将从指定的字节指针开始的一个字节序列解码为一组字符，并从指定的字符指针开始存储这组字符。
GetChars(Byte[])	在派生类中重写时，将指定字节数组中的所有字节解码为一组字符。 (继承自 Encoding)
GetChars(Byte[], Int32, Int32)	在派生类中重写时，将指定字节数组中的一个字节序列解码为一组字符。 (继承自 Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	将指定字节数组中的一个字节序列解码为指定的字符数组。
GetChars(ReadOnlySpan<Byte>, Span<Char>)	在派生类中重写时，将指定只读字节范围中的所有字节解码为字符范围。 (继承自 Encoding)
GetDecoder()	获取可以将 UTF-7 编码的字节序列转换为 Unicode 字符序列的解码器。
GetEncoder()	获取可将 Unicode 字符序列转换为 UTF-7 编码的字节序列的编码器。
GetHashCode()	返回当前 UTF7Encoding 对象的哈希代码。
GetMaxByteCount(Int32)	计算对指定数目的字符进行编码时产生的最大字节数。
GetMaxCharCount(Int32)	计算对指定数目的字节进行解码时产生的最大字符数。
GetPreamble()	在派生类中重写时，返回指定所用编码的字节序列。 (继承自 Encoding)
GetString(Byte*, Int32)	在派生类中重写时，将在指定地址开始的指定字节数解码为字符串。 (继承自 Encoding)
GetString(Byte[])	在派生类中重写时，将指定字节数组中的所有字节解码为一个字符串。 (继承自 Encoding)
GetString(Byte[], Int32, Int32)	将字节数组中某个范围的字节解码为一个字符串。
GetString(ReadOnlySpan<Byte>)	在派生类中重写时，将指定字节范围中的所有字节解码为一个字符串。 (继承自 Encoding)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsAlwaysNormalized()	使用默认范式获取一个值，该值指示当前编码是否始终被规范化。 (继承自 Encoding)
IsAlwaysNormalized(NormalizationForm)	在派生类中重写时，使用指定范式获取一个值，该值指示当前编码是否始终被规范化。 (继承自 Encoding)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	如果目标足够大，则从指定的只读范围将一组字符编码为字节范围。 (继承自 Encoding)
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	如果目标足够大，则从指定的只读范围将一组字节解码为字符范围。 (继承自 Encoding)

扩展方法

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。

另请参阅

• Decoder
• Encoder
• 了解编码