Encoding Classe

Définition

Espace de noms:: System.Text

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

Assembly:: mscorlib.dll

Assembly:: System.Text.Encoding.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 de caractères.

public ref class Encoding abstract

public ref class Encoding abstract : ICloneable

public abstract class Encoding

[System.Serializable]
public abstract class Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable

public abstract class Encoding : ICloneable

type Encoding = class

[<System.Serializable>]
type Encoding = class

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

type Encoding = class
    interface ICloneable

Public MustInherit Class Encoding

Public MustInherit Class Encoding
Implements ICloneable

Héritage: Object
Encoding

Dérivé: System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Attributs: SerializableAttribute ComVisibleAttribute

Implémente: ICloneable

Exemples

L’exemple suivant convertit une chaîne d’un encodage en un autre.

Note

Le byte[] tableau est le seul type de cet exemple qui contient les données encodées. Les types .NET Char et String sont eux-mêmes Unicode. Par conséquent, l’appel GetChars décode les données en Unicode.

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

Imports System.Text

Class Example
   Shared Sub Main()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As New String(asciiChars)

      ' Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString)
      Console.WriteLine("Ascii converted string: {0}", asciiString)
   End Sub
End Class
' The example displays the following output:
'    Original string: This string contains the unicode character Pi (Π)
'    Ascii converted string: This string contains the unicode character Pi (?)

Remarques

Pour plus d’informations sur cette API, consultez les remarques supplémentaires sur l’API pour l’encodage.

Constructeurs

Nom	Description
Encoding()	Initialise une nouvelle instance de la classe Encoding.
Encoding(Int32, EncoderFallback, DecoderFallback)	Initialise une nouvelle instance de la Encoding classe qui correspond à la page de codes spécifiée avec les stratégies de secours de l’encodeur et du décodeur spécifiés.
Encoding(Int32)	Initialise une nouvelle instance de la Encoding classe qui correspond à la page de codes spécifiée.

Propriétés

Nom	Description
ASCII	Obtient un encodage pour le jeu de caractères ASCII (7 bits).
BigEndianUnicode	Obtient un encodage pour le format UTF-16 qui utilise l’ordre d’octets big endian.
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.
CodePage	En cas de substitution dans une classe dérivée, obtient l’identificateur de la page de codes du fichier actif Encoding.
DecoderFallback	Obtient ou définit l’objet DecoderFallback de l’objet actif Encoding .
Default	Obtient l’encodage par défaut pour cette implémentation .NET.
EncoderFallback	Obtient ou définit l’objet EncoderFallback de l’objet actif Encoding .
EncodingName	En cas de substitution dans une classe dérivée, obtient la description lisible par l’homme de l’encodage actuel.
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.
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.
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.
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.
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.
IsReadOnly	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l’encodage actuel est en lecture seule.
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.
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é.
Unicode	Obtient un encodage pour le format UTF-16 à l’aide de l’ordre d’octet petit endian.
UTF32	Obtient un encodage pour le format UTF-32 à l’aide de l’ordre d’octet petit endian.
UTF7	Obtient un encodage pour le format UTF-7.
UTF8	Obtient un encodage pour le format UTF-8.
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.
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.

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 .
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Convertit une plage d’octets dans un tableau d’octets d’un encodage à un autre.
Convert(Encoding, Encoding, Byte[])	Convertit un tableau d’octets entier d’un encodage en un autre.
Equals(Object)	Détermine si le spécifié Object est égal à l’instance actuelle.
GetByteCount(Char[], 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 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é.
GetByteCount(Char*, 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 commençant par le pointeur de caractères 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.
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.
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.
GetBytes(Char[], Int32, Int32, Byte[], 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 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.
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.
GetBytes(Char, Int32, Byte, Int32)	En cas de substitution dans une classe dérivée, encode un jeu de caractères commençant par le pointeur de caractères spécifié dans une séquence d’octets stockées à 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.
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é.
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`.
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.
GetCharCount(Byte[], Int32, Int32)	En cas de substitution dans une classe dérivée, calcule le nombre de caractères produits 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é.
GetCharCount(Byte*, Int32)	En cas de substitution dans une classe dérivée, calcule le nombre de caractères produits 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.
GetChars(Byte[], Int32, Int32, Char[], 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 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.
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.
GetChars(Byte, Int32, Char, Int32)	En cas de substitution dans une classe dérivée, décode une séquence d’octets commençant par le 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.
GetDecoder()	En cas de substitution dans une classe dérivée, obtient un décodeur qui convertit une séquence codée d’octets en une séquence de caractères.
GetEncoder()	En cas de substitution dans une classe dérivée, obtient un encodeur qui convertit une séquence de caractères Unicode en séquence codée d’octets.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Retourne l’encodage associé à l’identificateur de page de codes spécifié. Les paramètres spécifient un gestionnaire d’erreurs pour les caractères qui ne peuvent pas être encodés et des séquences d’octets qui ne peuvent pas être décodées.
GetEncoding(Int32)	Retourne l’encodage associé à l’identificateur de page de codes spécifié.
GetEncoding(String, EncoderFallback, DecoderFallback)	Retourne l’encodage associé au nom de la page de codes spécifiée. Les paramètres spécifient un gestionnaire d’erreurs pour les caractères qui ne peuvent pas être encodés et des séquences d’octets qui ne peuvent pas être décodées.
GetEncoding(String)	Retourne l’encodage associé au nom de la page de codes spécifiée.
GetEncodings()	Retourne un tableau qui contient tous les encodages.
GetHashCode()	Retourne le code de hachage de l’instance actuelle.
GetMaxByteCount(Int32)	En cas de substitution dans une classe dérivée, calcule le nombre maximal d’octets générés par l’encodage du nombre spécifié de caractères.
GetMaxCharCount(Int32)	En cas de substitution dans une classe dérivée, calcule le nombre maximal de caractères produits par le 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é.
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.
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.
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.
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.
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.
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é.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
RegisterProvider(EncodingProvider)	Inscrit un fournisseur d’encodage.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Comment utiliser des classes d’encodage de caractères dans .NET

Commentaires

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