UTF8Encoding, classe

L'encodage est le processus de transformation d'un jeu de caractères Unicode en une séquence d'octets. Le décodage est le processus qui consiste à transformer une séquence d'octets encodés en un jeu de caractères Unicode.

L'encodage UTF-8 représente chaque point de code sous la forme d'une séquence d'un à quatre octets. Pour plus d'informations sur les UTFs et d'autres encodages pris en charge par System.Text, consultez Encodage de caractères dans le .NET Framework et Utilisation de l'encodage Unicode.

La méthode GetByteCount détermine le nombre d'octets entraînant l'encodage d'un jeu de caractères Unicode, et la méthode GetBytes exécute cet encodage.

De même, la méthode GetCharCount détermine le nombre de caractères entraînant le décodage d'une séquence d'octets, et les méthodes GetChars et GetString procèdent au décodage effectif.

UTF8Encoding correspond à la page de codes 65001 de Windows.

L'encodeur peut utiliser l'ordre d'octet avec primauté des octets de poids fort (big-endian) (octet le plus significatif en premier) ou avec primauté des octets de poids fiable (little-endian) (octet le moins significatif en premier). Il est généralement plus efficace d'utiliser l'ordre d'octet natif pour stocker des caractères Unicode. Par exemple, il est préférable d'utiliser l'ordre d'octet avec primauté des octets de poids faible (little-endian) sur les plateformes little-endian, comme les ordinateurs Intel.

Le cas échéant, l'objet UTF8Encoding fournit un préambule, c'est-à-dire un tableau d'octets que vous pouvez ajouter en tant que préfixe à la séquence d'octets résultant du processus d'encodage. Si le préambule contient une marque d'ordre d'octet (BOM), il aide le décodeur à déterminer l'ordre d'octet et le format UTF. La méthode GetPreamble extrait un tableau des octets qui peuvent inclure le BOM. Pour plus d'informations sur l'ordre d'octet et la marque d'ordre d'octet, consultez la norme Unicode sur la page d'accueil Unicode.

Remarque

Pour activer la détection d'erreurs et rendre l'instance de classe plus sécurisée, l'application doit utiliser le constructeur UTF8Encoding qui prend un paramètre throwOnInvalidBytes et le définit avec la valeur true. Avec la détection d'erreurs, une méthode qui détecte une séquence non valide de caractères ou d'octets lève une exception ArgumentException. Sans détection d'erreurs, aucune exception n'est levée, et la séquence non valide est généralement ignorée.

Remarque
L'état d'un objet encodé UTF-8 n'est pas préservé si l'objet est sérialisé et désérialisé à l'aide de différentes versions du .NET Framework.

L'exemple suivant illustre l'utilisation de UTF8Encoding pour encoder une chaîne de caractères Unicode et la stocker dans le tableau d'octets. Notez qu'il n'y a aucune perte de données lorsque encodedBytes est décodé à nouveau en chaîne.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        // Create a UTF-8 encoding.
        UTF8Encoding utf8 = new UTF8Encoding();

        // A Unicode string with two characters outside an 8-bit code range.
        String unicodeString =
            "This unicode string contains two characters " +
            "with codes outside an 8-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf8.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 = utf8.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources