UTF7Encoding.GetEncoder Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá kodér, který převede posloupnost znaků Unicode na posloupnost kódování UTF-7 bajtů.
public:
override System::Text::Encoder ^ GetEncoder();public override System.Text.Encoder GetEncoder();override this.GetEncoder : unit -> System.Text.EncoderPublic Overrides Function GetEncoder () As EncoderNávraty
A Encoder , který převede posloupnost znaků Unicode na kódování UTF-7 sekvence bajtů.
Příklady
Následující příklad kódu ukazuje, jak pomocí GetEncoder metody získat kodér pro převod sekvence znaků na kódování UTF-7 zakódované sekvence bajtů.
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
Poznámky
Metoda Decoder.GetChars převádí sekvenční bloky bajtů na sekvenční bloky znaků způsobem podobným GetChars metodě. Udržuje však informace o stavu mezi voláními, Decoder aby bylo možné správně dekódovat bajtové sekvence, které pokrývají bloky. Zároveň Decoder zachovává koncové bajty na konci datových bloků a používá koncové bajty v další dekódovací operaci. GetDecoder Proto jsou GetEncoder užitečné pro síťové přenosy a operace se soubory, protože tyto operace často zpracovávají bloky dat místo kompletního datového proudu.
