UTF7Encoding.GetEncoder 方法

定義

命名空間:
System.Text
組件:
mscorlib.dll, System.Text.Encoding.Extensions.dll
組件:
mscorlib.dll
組件:
System.Text.Encoding.Extensions.dll
組件:
netstandard.dll

取得一個編碼器，能將一串 Unicode 字元轉換成 UTF-7 編碼的位元組序列。

public:
 override System::Text::Encoder ^ GetEncoder();
public override System.Text.Encoder GetEncoder();
override this.GetEncoder : unit -> System.Text.Encoder
Public Overrides Function GetEncoder () As Encoder

傳回

Encoder

Encoder A 將一連串 Unicode 字元轉換成 UTF-7 編碼的位元組序列。

範例

以下程式碼範例示範如何使用此 GetEncoder 方法取得編碼器，將一串字元轉換為 UTF-7 編碼的位元組序列。

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        Char[] chars = new Char[] {'a', 'b', 'c', '\u0300', '\ua0a0'};
        Byte[] bytes;

        Encoder utf7Encoder = Encoding.UTF7.GetEncoder();

        int byteCount = utf7Encoder.GetByteCount(chars, 2, 3, true);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf7Encoder.GetBytes(chars, 2, 3, bytes, 0, true);

        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        'Characters:
        ' ChrW(97) = a
        ' ChrW(98) = b
        ' ChrW(99) = c
        ' ChrW(768) = `
        ' ChrW(41120) = valid unicode code point, but not a character
        Dim chars() As Char = {ChrW(97), ChrW(98), ChrW(99), ChrW(768), ChrW(41120)}
        Dim bytes() As Byte
        
        Dim utf7Encoder As Encoder = Encoding.UTF7.GetEncoder()
        
        Dim byteCount As Integer = utf7Encoder.GetByteCount(chars, 2, 3, True)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf7Encoder.GetBytes(chars, 2, 3, bytes, 0, True)
        
        Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

備註

此 Decoder.GetChars 方法將連續的位元組區塊轉換為連續的字元區塊，方式與該 GetChars 方法相似。 然而，a Decoder 會維持呼叫間的狀態資訊，以便正確解碼跨區塊的位元組序列。 同時 Decoder 會保留資料區塊末尾的尾部位元組，並在下一次解碼操作中使用這些尾部位元組。 因此， GetDecoder 和 GetEncoder 對於網路傳輸和檔案操作非常有用，因為這些操作通常處理的是資料區塊，而非完整的資料流。

適用於

另請參閱