UTF7Encoding Classe

Définition

Espace de noms:: System.Text

Assemblys:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un encodage UTF-7 de caractères Unicode.

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

public class UTF7Encoding : System.Text.Encoding

[System.Serializable]
public class UTF7Encoding : System.Text.Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UTF7Encoding : System.Text.Encoding

type UTF7Encoding = class
    inherit Encoding

[<System.Serializable>]
type UTF7Encoding = class
    inherit Encoding

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Héritage: Object

Encoding
UTF7Encoding

Attributs: SerializableAttribute ComVisibleAttribute

Exemples

L’exemple de code suivant montre comment utiliser une UTF7Encoding chaîne de caractères Unicode et les stocker dans un tableau d’octets. Notez que lorsque le tableau d’octets est décodé en chaîne, aucune donnée n’est perdue.

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

Remarques

L’encodage est le processus de transformation d’un ensemble de caractères Unicode en une séquence d’octets. Le décodage est le processus de transformation d’une séquence d’octets encodés en un ensemble de caractères Unicode.

L’encodage UTF-7 représente des caractères Unicode sous forme de séquences de caractères ASCII 7 bits. Cet encodage prend en charge certains protocoles pour lesquels il est nécessaire, le plus souvent les protocoles de messagerie ou de groupe de news. Étant donné que UTF-7 n’est pas particulièrement sécurisé ou robuste et que la plupart des systèmes modernes autorisent des encodages 8 bits, UTF-8 doit normalement être préféré à UTF-7.

Note

UTF7Encoding ne fournit pas de détection d’erreur. Pour des raisons de sécurité, l’application doit utiliser UTF8Encoding, UnicodeEncodingou UTF32Encoding activer la détection des erreurs.

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.

La GetByteCount méthode détermine le nombre d’octets résultant de l’encodage d’un jeu de caractères Unicode, et la GetBytes méthode effectue l’encodage réel.

De même, la GetCharCount méthode détermine le nombre de caractères qui entraînent le décodage d’une séquence d’octets et les GetChars GetString méthodes effectuent le décodage réel.

UTF7Encoding correspond à la page de codes Windows 65000.

Note

L’état d’un objet encodé en UTF-7 n’est pas conservé si l’objet est sérialisé et désérialisé à l’aide de différentes versions .NET Framework.

Constructeurs

Nom	Description
UTF7Encoding()	Initialise une nouvelle instance de la classe UTF7Encoding.
UTF7Encoding(Boolean)	Initialise une nouvelle instance de la classe UTF7Encoding. Un paramètre spécifie s’il faut autoriser les caractères facultatifs.

Propriétés

Nom	Description
BodyName	En cas de substitution dans une classe dérivée, obtient un nom pour l’encodage actuel qui peut être utilisé avec des balises de corps de l’agent de messagerie. (Hérité de Encoding)
CodePage	En cas de substitution dans une classe dérivée, obtient l’identificateur de la page de codes du fichier actif Encoding. (Hérité de Encoding)
DecoderFallback	Obtient ou définit l’objet DecoderFallback de l’objet actif Encoding . (Hérité de Encoding)
EncoderFallback	Obtient ou définit l’objet EncoderFallback de l’objet actif Encoding . (Hérité de Encoding)
EncodingName	En cas de substitution dans une classe dérivée, obtient la description lisible par l’homme de l’encodage actuel. (Hérité de Encoding)
HeaderName	En cas de substitution dans une classe dérivée, obtient un nom pour l’encodage actuel qui peut être utilisé avec les balises d’en-tête de l’agent de messagerie. (Hérité de Encoding)
IsBrowserDisplay	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel peut être utilisé par les clients de navigateur pour afficher du contenu. (Hérité de Encoding)
IsBrowserSave	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel peut être utilisé par les clients de navigateur pour enregistrer du contenu. (Hérité de Encoding)
IsMailNewsDisplay	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel peut être utilisé par les clients de messagerie et d’actualités pour afficher du contenu. (Hérité de Encoding)
IsMailNewsSave	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel peut être utilisé par les clients de messagerie et d’actualités pour enregistrer du contenu. (Hérité de Encoding)
IsReadOnly	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel est en lecture seule. (Hérité de Encoding)
IsSingleByte	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel utilise des points de code à octet unique. (Hérité de Encoding)
Preamble	En cas de substitution dans une classe dérivée, retourne une étendue contenant la séquence d’octets qui spécifie l’encodage utilisé. (Hérité de Encoding)
WebName	En cas de substitution dans une classe dérivée, obtient le nom inscrit auprès de l’IANA (Internet Assigned Numbers Authority) pour l’encodage actuel. (Hérité de Encoding)
WindowsCodePage	En cas de substitution dans une classe dérivée, obtient la page de codes du système d’exploitation Windows qui correspond le plus étroitement à l’encodage actuel. (Hérité de Encoding)

Méthodes

Nom	Description
Clone()	En cas de substitution dans une classe dérivée, crée une copie superficielle de l’objet actuel Encoding . (Hérité de Encoding)
Equals(Object)	Obtient une valeur indiquant si l’objet spécifié est égal à l’objet actuel UTF7Encoding .
Equals(Object)	Détermine si le spécifié Object est égal à l’instance actuelle. (Hérité de Encoding)
GetByteCount(Char[], Int32, Int32)	Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères à partir du tableau de caractères spécifié.
GetByteCount(Char[])	En cas de substitution dans une classe dérivée, calcule le nombre d’octets produits par l’encodage de tous les caractères du tableau de caractères spécifié. (Hérité de Encoding)
GetByteCount(Char*, Int32)	Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères commençant par le pointeur de caractère spécifié.
GetByteCount(ReadOnlySpan<Char>)	En cas de substitution dans une classe dérivée, calcule le nombre d’octets produits par l’encodage des caractères dans l’étendue de caractères spécifiée. (Hérité de Encoding)
GetByteCount(String, Int32, Int32)	En cas de substitution dans une classe dérivée, calcule le nombre d’octets produits par l’encodage d’un jeu de caractères à partir de la chaîne spécifiée. (Hérité de Encoding)
GetByteCount(String)	Calcule le nombre d’octets générés par l’encodage des caractères dans l’objet spécifié String .
GetByteCount(String)	En cas de substitution dans une classe dérivée, calcule le nombre d’octets produits par l’encodage des caractères dans la chaîne spécifiée. (Hérité de Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Encode un jeu de caractères du tableau de caractères spécifié dans le tableau d’octets spécifié.
GetBytes(Char[], Int32, Int32)	En cas de substitution dans une classe dérivée, encode un jeu de caractères du tableau de caractères spécifié dans une séquence d’octets. (Hérité de Encoding)
GetBytes(Char[])	En cas de substitution dans une classe dérivée, encode tous les caractères du tableau de caractères spécifié dans une séquence d’octets. (Hérité de Encoding)
GetBytes(Char, Int32, Byte, Int32)	Encode un jeu de caractères commençant par le pointeur de caractères spécifié dans une séquence d’octets stockés à partir du pointeur d’octet spécifié.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	En cas de substitution dans une classe dérivée, encode dans une étendue d’octets un jeu de caractères de l’étendue en lecture seule spécifiée. (Hérité de Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Encode un jeu de caractères du tableau d’octets String spécifié.
GetBytes(String, Int32, Int32, Byte[], Int32)	En cas de substitution dans une classe dérivée, encode un jeu de caractères de la chaîne spécifiée dans le tableau d’octets spécifié. (Hérité de Encoding)
GetBytes(String, Int32, Int32)	En cas de substitution dans une classe dérivée, encode dans un tableau d’octets le nombre de caractères spécifié par `count` la chaîne spécifiée, à partir de la valeur spécifiée `index`. (Hérité de Encoding)
GetBytes(String)	En cas de substitution dans une classe dérivée, encode tous les caractères de la chaîne spécifiée dans une séquence d’octets. (Hérité de Encoding)
GetCharCount(Byte[], Int32, Int32)	Calcule le nombre de caractères générés par le décodage d’une séquence d’octets à partir du tableau d’octets spécifié.
GetCharCount(Byte[])	En cas de substitution dans une classe dérivée, calcule le nombre de caractères produits par le décodage de tous les octets du tableau d’octets spécifié. (Hérité de Encoding)
GetCharCount(Byte*, Int32)	Calcule le nombre de caractères générés par le décodage d’une séquence d’octets commençant au pointeur d’octet spécifié.
GetCharCount(ReadOnlySpan<Byte>)	En cas de substitution dans une classe dérivée, calcule le nombre de caractères produits par le décodage de l’étendue d’octets en lecture seule fournie. (Hérité de Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Décode une séquence d’octets du tableau d’octets spécifié dans le tableau de caractères spécifié.
GetChars(Byte[], Int32, Int32)	En cas de substitution dans une classe dérivée, décode une séquence d’octets du tableau d’octets spécifié en un ensemble de caractères. (Hérité de Encoding)
GetChars(Byte[])	En cas de substitution dans une classe dérivée, décode tous les octets du tableau d’octets spécifié en un ensemble de caractères. (Hérité de Encoding)
GetChars(Byte, Int32, Char, Int32)	Décode une séquence d’octets commençant au pointeur d’octet spécifié dans un ensemble de caractères stockés à partir du pointeur de caractères spécifié.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	En cas de substitution dans une classe dérivée, décode tous les octets de l’étendue d’octets en lecture seule spécifiée dans une étendue de caractères. (Hérité de Encoding)
GetDecoder()	Obtient un décodeur qui convertit une séquence encodée UTF-7 d’octets en une séquence de caractères Unicode.
GetEncoder()	Obtient un encodeur qui convertit une séquence de caractères Unicode en une séquence codée en UTF-7 d’octets.
GetHashCode()	Retourne le code de hachage de l’objet actif UTF7Encoding .
GetHashCode()	Retourne le code de hachage de l’instance actuelle. (Hérité de Encoding)
GetMaxByteCount(Int32)	Calcule le nombre maximal d’octets produits par encodage du nombre spécifié de caractères.
GetMaxCharCount(Int32)	Calcule le nombre maximal de caractères produits par décodage du nombre spécifié d’octets.
GetPreamble()	En cas de substitution dans une classe dérivée, retourne une séquence d’octets qui spécifie l’encodage utilisé. (Hérité de Encoding)
GetString(Byte[], Int32, Int32)	Décode une plage d’octets d’un tableau d’octets dans une chaîne.
GetString(Byte[], Int32, Int32)	En cas de substitution dans une classe dérivée, décode une séquence d’octets du tableau d’octets spécifié dans une chaîne. (Hérité de Encoding)
GetString(Byte[])	En cas de substitution dans une classe dérivée, décode tous les octets du tableau d’octets spécifié dans une chaîne. (Hérité de Encoding)
GetString(Byte*, Int32)	En cas de substitution dans une classe dérivée, décode un nombre spécifié d’octets à partir d’une adresse spécifiée dans une chaîne. (Hérité de Encoding)
GetString(ReadOnlySpan<Byte>)	En cas de substitution dans une classe dérivée, décode tous les octets de l’étendue d’octets spécifiée dans une chaîne. (Hérité de Encoding)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsAlwaysNormalized()	Obtient une valeur indiquant si l’encodage actuel est toujours normalisé, à l’aide du formulaire de normalisation par défaut. (Hérité de Encoding)
IsAlwaysNormalized(NormalizationForm)	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel est toujours normalisé, à l’aide du formulaire de normalisation spécifié. (Hérité de Encoding)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?