UTF7Encoding-Klasse

Beim Codieren werden Unicode-Zeichen in eine Bytefolge transformiert. Beim Decodieren wird eine Folge codierter Bytes in Unicode-Zeichen transformiert.

Die UTF-7-Codierung stellt Unicode-Zeichen als Sequenzen von 7-Bit-ASCII-Zeichen dar. Diese Codierung unterstützt bestimmte Protokolle, für die sie erforderlich ist. Im Allgemeinen handelt es sich dabei um E-Mail- oder Newsgroup-Protokolle. Da UTF-7 nicht besonders sicher oder robust ist und die meisten modernen Systeme 8-Bit-Codierungen unterstützen, sollte UTF-8 im Allgemeinen gegenüber UFT-7 der Vorzug gegeben werden.

Hinweis
UTF7Encoding stellt keine Fehlererkennung bereit. Aus Sicherheitsgründen wird empfohlen, dass die Anwendung UTF8Encoding, UnicodeEncoding oder UTF32Encoding verwendet und die Fehlererkennung aktiviert wird.

Weitere Informationen über die UTFs und andere Codierungen, die von System.Text unterstützt werden, finden Sie unter Zeichencodierung in .NET Framework.

Mit der GetByteCount-Methode wird bestimmt, wie viele Bytes sich beim Codieren einer Reihe von Unicode-Zeichen ergeben, und die GetBytes-Methode führt die eigentliche Codierung aus.

Analog dazu bestimmt die GetCharCount-Methode, wie viele Zeichen sich aus der Decodierung einer Bytefolge ergeben, und die GetChars-Methode und die GetString-Methode führen die eigentliche Decodierung aus.

UTF7Encoding entspricht der Windows-Codepage 65000.

Hinweis
Der Zustand eines UTF-7-codierten Objektes wird nicht beibehalten, wenn das Objekt mit verschiedenen Versionen von .NET Framework serialisiert und deserialisiert wird.

Im folgenden Codebeispiel wird veranschaulicht, wie mit UTF7Encoding eine Folge von Unicode-Zeichen codiert und in einem Bytearray gespeichert wird. Beachten Sie, dass keine Daten verloren gehen, wenn das Bytearray wieder in eine Zeichenfolge decodiert wird.

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);
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen