Encoding Classe

Définition

Espace de noms:

System.Text

Assembly:

System.Runtime.dll

Source:

Encoding.cs

Représente un encodage de caractères.

public ref class Encoding abstract : ICloneable

public abstract class Encoding : ICloneable

type Encoding = class
    interface ICloneable

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

Implémente

ICloneable

Exemples

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

Notes

Le byte[] tableau est le seul type dans cet exemple qui contient les données encodées. Le .NET Char et les String types sont eux-mêmes Unicode, de sorte que l' GetChars appel décode les données au format Unicode.

using namespace System;
using namespace System::Text;

int 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.
   array<Byte>^unicodeBytes = unicode->GetBytes( unicodeString );
   
   // Perform the conversion from one encoding to the other.
   array<Byte>^asciiBytes = Encoding::Convert( unicode, ascii, unicodeBytes );
   
   // Convert the new Byte into[] a char and[] then into a string.
   array<Char>^asciiChars = gcnew array<Char>(ascii->GetCharCount( asciiBytes, 0, asciiBytes->Length ));
   ascii->GetChars( asciiBytes, 0, asciiBytes->Length, asciiChars, 0 );
   String^ asciiString = gcnew 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 (?)

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 Remarques supplémentaires sur l’API pour l’encodage.

Constructeurs

Encoding()	Initialise une nouvelle instance de la classe Encoding.
Encoding(Int32)	Initialise une nouvelle instance de la classe Encoding qui correspond à la page de codes spécifiée.
Encoding(Int32, EncoderFallback, DecoderFallback)	Initialise une nouvelle instance de la classe Encoding qui correspond à la page de code spécifiée avec les stratégies de secours d'encodeur et de décodeur spécifiées.

Propriétés

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'octet avec primauté des octets de poids fort (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 les étiquettes de corps de texte 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 Encoding actuel.
DecoderFallback	Obtient ou définit l'objet DecoderFallback actuel de l'objet Encoding actuel.
Default	Obtient l’encodage par défaut pour cette implémentation .NET.
EncoderFallback	Obtient ou définit l'objet EncoderFallback actuel de l'objet Encoding actuel.
EncodingName	En cas de substitution dans une classe dérivée, obtient la description explicite 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 étiquettes 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 navigation pour afficher le 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 navigation 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 de news 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 de news 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 codés sur un octet.
Latin1	Obtient un encodage pour le jeu de caractères Latin1 (ISO-8859-1).
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 avec primauté des octets de poids faible (little-endian).
UTF32	Obtient un encodage pour le format UTF-32 avec primauté des octets de poids faible (little-endian).
UTF7	Obsolète. 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 la plus proche de l'encodage actuel.

Méthodes

Clone()	En cas de substitution dans une classe dérivée, crée une copie superficielle de l'objet Encoding actuel.
Convert(Encoding, Encoding, Byte[])	Convertit un tableau d'octets entier d'un encodage à un autre.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Convertit une plage d'octets d'un encodage à un autre dans un tableau d'octets.
CreateTranscodingStream(Stream, Encoding, Encoding, Boolean)	Crée un Stream qui sert à transcoder des données entre un Encoding interne et un Encoding externe, semblable à Convert(Encoding, Encoding, Byte[]).
Equals(Object)	Détermine si le Object spécifié est égal à l'instance actuelle.
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 au pointeur de caractère 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, 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 du tableau 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 de tous les caractères de l’étendue de caractères 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 de la chaîne 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 de la chaîne spécifiée.
GetBytes(Char*, Int32, Byte*, Int32)	En cas de substitution dans une classe dérivée, encode un jeu de caractères commençant au pointeur de caractère spécifié en une séquence d'octets stockés à partir du pointeur d'octet spécifié.
GetBytes(Char[])	En cas de substitution dans une classe dérivée, encode tous les caractères du tableau de caractères spécifié en une séquence d'octets.
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é en une séquence d'octets.
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é en tableau d'octets.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	En cas de substitution dans une classe dérivée, encode un jeu de caractères du tableau de caractères en lecture seule spécifié en séquence d'octets.
GetBytes(String)	En cas de substitution dans une classe dérivée, encode tous les caractères de la chaîne spécifiée en une séquence d'octets.
GetBytes(String, Int32, Int32)	En cas de substitution dans une classe dérivée, encode en un tableau d'octets le nombre de caractères spécifié par count dans la chaîne spécifiée, à partir de l’élément index 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 en 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(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, 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 du tableau d'octets 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, Char*, Int32)	En cas de substitution dans une classe dérivée, décode une séquence d'octets commençant au pointeur d'octet spécifié en un jeu de caractères stockés à partir du pointeur de caractère spécifié.
GetChars(Byte[])	En cas de substitution dans une classe dérivée, décode tous les octets du tableau d'octets spécifié en jeu de caractères.
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 jeu de caractères.
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é en tableau 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 en jeu de caractères.
GetDecoder()	En cas de substitution dans une classe dérivée, obtient un décodeur qui convertit une séquence d'octets encodée en 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 d'octets encodée.
GetEncoding(Int32)	Retourne l'encodage associé à l'identificateur de page de codes spécifié.
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 pour les 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.
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 pour les séquences d'octets qui ne peuvent pas être décodées.
GetEncodings()	Retourne un tableau qui contient tous les encodages.
GetHashCode()	Retourne le code de hachage pour l'instance actuelle.
GetMaxByteCount(Int32)	En cas de substitution dans une classe dérivée, calcule le nombre maximal d'octets produits par l'encodage du nombre de caractères spécifié.
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 de caractères spécifié.
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)	En cas de substitution dans une classe dérivée, décode un nombre d'octets spécifié en commençant à une adresse spécifiée 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é en 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é en 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 en chaîne.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsAlwaysNormalized()	Obtient une valeur indiquant si l'encodage actuel est toujours normalisé en utilisant le 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é en utilisant le formulaire de normalisation spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RegisterProvider(EncodingProvider)	Enregistre un fournisseur d'encodage.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Encode dans une plage d’octets un ensemble de caractères de l’étendue en lecture seule spécifiée si la destination est suffisamment grande.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Décode en une étendue de caractères un ensemble d’octets de l’étendue en lecture seule spécifiée si la destination est suffisamment grande.

Méthodes d’extension

GetBytes(Encoding, ReadOnlySequence<Char>)	Encode le ReadOnlySequence<T> spécifié dans un tableau Byte à l’aide du Encoding spécifié.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Décode le ReadOnlySequence<T> spécifié en bytes à l’aide du Encoding spécifié et écrit le résultat dans writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Encode le ReadOnlySequence<T> spécifié en bytes à l’aide du Encoding spécifié et génère le résultat dans bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Encode le ReadOnlySpan<T> spécifié en bytes à l’aide du Encoding spécifié et écrit le résultat dans writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Décode le ReadOnlySequence<T> spécifié en chars à l’aide du Encoding spécifié et écrit le résultat dans writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Décode le ReadOnlySequence<T> spécifié en chars à l’aide du Encoding spécifié et génère le résultat dans chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Décode le ReadOnlySpan<T> spécifié en chars à l’aide du Encoding spécifié et écrit le résultat dans writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Décode le ReadOnlySequence<T> spécifié en un String à l’aide du Encoding spécifié.

Voir aussi

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