Encoding Encoding Encoding Encoding Class

Définition

Représente un encodage de caractères.Represents a character encoding.

public ref class Encoding abstract : ICloneable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Encoding : ICloneable
type Encoding = class
    interface ICloneable
Public MustInherit Class Encoding
Implements ICloneable
Héritage
EncodingEncodingEncodingEncoding
Dérivé
Attributs
Implémente

Exemples

L’exemple suivant convertit une chaîne d’un encodage à un autre.The following example converts a string from one encoding to another.

Notes

Le tableau Byte [] est le seul type dans cet exemple qui contient les données encodées.The byte[] array is the only type in this example that contains the encoded data. Les types .net char et String sont eux-mêmes Unicode, GetChars de sorte que l’appel décode les données au format Unicode.The .NET Char and String types are themselves Unicode, so the GetChars call decodes the data back to 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

L'encodage est le processus de transformation d'un jeu de caractères Unicode en une séquence d'octets.Encoding is the process of transforming a set of Unicode characters into a sequence of bytes. En revanche, le décodage est le processus de transformation d’une séquence d’octets encodés en un jeu de caractères Unicode.In contrast, decoding is the process of transforming a sequence of encoded bytes into a set of Unicode characters. Pour plus d’informations sur les formats de transformation Unicode (UTFs) et d’autres encodages pris en charge par Encoding, consultez encodage de caractères dans .net.For information about the Unicode Transformation Formats (UTFs) and other encodings supported by Encoding, see Character Encoding in .NET.

Notez que Encoding est conçu pour fonctionner sur des caractères Unicode au lieu de données binaires arbitraires, telles que des tableaux d’octets.Note that Encoding is intended to operate on Unicode characters instead of arbitrary binary data, such as byte arrays. Si vous devez encoder des données binaires arbitraires en texte, vous devez utiliser un protocole tel qu’UUEncode, qui est Convert.ToBase64CharArrayimplémenté par des méthodes telles que.If you must encode arbitrary binary data into text, you should use a protocol such as uuencode, which is implemented by methods such as Convert.ToBase64CharArray.

.NET fournit les implémentations suivantes de la Encoding classe pour prendre en charge les encodages Unicode et autres encodages actuels :.NET provides the following implementations of the Encoding class to support current Unicode encodings and other encodings:

  • ASCIIEncodingencode les caractères Unicode sous la forme de caractères ASCII 7 bits uniques.ASCIIEncoding encodes Unicode characters as single 7-bit ASCII characters. Cet encodage prend en charge uniquement les valeurs de caractères comprises entre U + 0000 et U + 007F.This encoding only supports character values between U+0000 and U+007F. Page de codes 20127.Code page 20127. Également disponible via la ASCII propriété.Also available through the ASCII property.

  • UTF7Encodingencode les caractères Unicode à l’aide de l’encodage UTF-7.UTF7Encoding encodes Unicode characters using the UTF-7 encoding. Cet encodage prend en charge toutes les valeurs de caractères Unicode.This encoding supports all Unicode character values. Page de codes 65000.Code page 65000. Également disponible via la UTF7 propriété.Also available through the UTF7 property.

  • UTF8Encodingencode les caractères Unicode à l’aide de l’encodage UTF-8.UTF8Encoding encodes Unicode characters using the UTF-8 encoding. Cet encodage prend en charge toutes les valeurs de caractères Unicode.This encoding supports all Unicode character values. Page de codes 65001.Code page 65001. Également disponible via la UTF8 propriété.Also available through the UTF8 property.

  • UnicodeEncodingencode les caractères Unicode à l’aide de l’encodage UTF-16.UnicodeEncoding encodes Unicode characters using the UTF-16 encoding. Les ordres Little endian et Big endian sont pris en charge.Both little endian and big endian byte orders are supported. Également disponible par le Unicode biais de la BigEndianUnicode propriété et de la propriété.Also available through the Unicode property and the BigEndianUnicode property.

  • UTF32Encodingencode les caractères Unicode à l’aide de l’encodage UTF-32.UTF32Encoding encodes Unicode characters using the UTF-32 encoding. Les ordres d’octet Little endian (page de codes 12000) et Big endian (page de codes 12001) sont pris en charge.Both little endian (code page 12000) and big endian (code page 12001) byte orders are supported. Également disponible via la UTF32 propriété.Also available through the UTF32 property.

La Encoding classe est principalement destinée à effectuer des conversions entre différents encodages et Unicode.The Encoding class is primarily intended to convert between different encodings and Unicode. Souvent, l’une des classes Unicode dérivées est le choix approprié pour votre application.Often one of the derived Unicode classes is the correct choice for your app.

Utilisez la GetEncoding méthode pour obtenir d’autres encodages et appelez la GetEncodings méthode pour obtenir la liste de tous les encodages.Use the GetEncoding method to obtain other encodings, and call the GetEncodings method to get a list of all encodings.

Le tableau suivant répertorie les encodages pris en charge par .NET Framework et .NET Core.The following table lists the encodings supported by .NET Framework and .NET Core. Elle répertorie le numéro de la page de codes de l’encodage et EncodingInfo.Name les EncodingInfo.DisplayName valeurs des propriétés et de l’encodage.It lists each encoding's code page number and the values of the encoding's EncodingInfo.Name and EncodingInfo.DisplayName properties. Une coche dans les colonnes support .NET Framework et prise en charge de .net Core indique que la page de codes est prise en charge en mode natif par cette implémentation .net, quelle que soit la plateforme sous-jacente.A check mark in the .NET Framework support and .NET Core support columns indicates that the code page is natively supported by that .NET implementation, regardless of the underlying platform. Par .NET Framework, la disponibilité des autres encodages listés dans le tableau dépend du système d’exploitation.For .NET Framework, the availability of other encodings listed in the table depends on the operating system. Pour .net Core, d’autres encodages sont disponibles en utilisant System.Text.CodePagesEncodingProvider la classe ou en dérivant de la System.Text.EncodingProvider classe.For .NET Core, other encodings are available by using the System.Text.CodePagesEncodingProvider class or by deriving from the System.Text.EncodingProvider class.

Notes

Les pages de EncodingInfo.Name codes dont la propriété correspond à une norme internationale ne sont pas nécessairement entièrement conformes à cette norme.Code pages whose EncodingInfo.Name property corresponds to an international standard do not necessarily comply in full with that standard.

Page de codesCode page NameName Nom completDisplay name Support .NET Framework.NET Framework support Support de .NET Core.NET Core support
3737 IBM037IBM037 IBM EBCDIC (États-Unis-Canada)IBM EBCDIC (US-Canada)
437437 IBM437IBM437 États-Unis OEMOEM United States
500500 IBM500IBM500 IBM EBCDIC (international)IBM EBCDIC (International)
708708 ASMO-708ASMO-708 Arabe (ASMO 708)Arabic (ASMO 708)
720720 DOS-720DOS-720 Arabe (DOS)Arabic (DOS)
737737 ibm737ibm737 Grec (DOS)Greek (DOS)
775775 ibm775ibm775 Balte (DOS)Baltic (DOS)
850850 ibm850ibm850 Europe occidentale (DOS)Western European (DOS)
852852 ibm852ibm852 Europe centrale (DOS)Central European (DOS)
855855 IBM855IBM855 OEM cyrilliqueOEM Cyrillic
857857 ibm857ibm857 Turc (DOS)Turkish (DOS)
858858 IBM00858IBM00858 Latin multilingue OEM IOEM Multilingual Latin I
860860 IBM860IBM860 Portugais (DOS)Portuguese (DOS)
861861 ibm861ibm861 Islandais (DOS)Icelandic (DOS)
862862 DOS-862DOS-862 Hébreu (DOS)Hebrew (DOS)
863863 IBM863IBM863 Français canadien (DOS)French Canadian (DOS)
864864 IBM864IBM864 Arabe (864)Arabic (864)
865865 IBM865IBM865 Nordique (DOS)Nordic (DOS)
866866 cp866cp866 Cyrillique (DOS)Cyrillic (DOS)
869869 ibm869ibm869 Grec, moderne (DOS)Greek, Modern (DOS)
870870 IBM870IBM870 IBM EBCDIC (multilingue Latin-2)IBM EBCDIC (Multilingual Latin-2)
874874 windows-874windows-874 Thaï (Windows)Thai (Windows)
875875 cp875cp875 IBM EBCDIC (grec moderne)IBM EBCDIC (Greek Modern)
932932 shift_jisshift_jis Japonais (Shift-JIS)Japanese (Shift-JIS)
936936 gb2312gb2312 Chinois simplifié (GB2312)Chinese Simplified (GB2312)
949949 ks_c_5601-1987ks_c_5601-1987 CoréenKorean
950950 big5big5 Chinois traditionnel (Big5)Chinese Traditional (Big5)
10261026 IBM1026IBM1026 IBM EBCDIC (turc latin-5)IBM EBCDIC (Turkish Latin-5)
10471047 IBM01047IBM01047 IBM latin-1IBM Latin-1
11401140 IBM01140IBM01140 IBM EBCDIC (États-Unis-Canada-Europe)IBM EBCDIC (US-Canada-Euro)
11411141 IBM01141IBM01141 IBM EBCDIC (Allemagne-Europe)IBM EBCDIC (Germany-Euro)
11421142 IBM01142IBM01142 IBM EBCDIC (Danemark-Norvège-euro)IBM EBCDIC (Denmark-Norway-Euro)
11431143 IBM01143IBM01143 IBM EBCDIC (Finlande-Suède-Europe)IBM EBCDIC (Finland-Sweden-Euro)
11441144 IBM01144IBM01144 IBM EBCDIC (Italie-Europe)IBM EBCDIC (Italy-Euro)
11451145 IBM01145IBM01145 IBM EBCDIC (Espagne-Europe)IBM EBCDIC (Spain-Euro)
11461146 IBM01146IBM01146 IBM EBCDIC (Royaume-Uni-Europe)IBM EBCDIC (UK-Euro)
11471147 IBM01147IBM01147 IBM EBCDIC (France-Europe)IBM EBCDIC (France-Euro)
11481148 IBM01148IBM01148 IBM EBCDIC (International-Europe)IBM EBCDIC (International-Euro)
11491149 IBM01149IBM01149 IBM EBCDIC (islandais-euro)IBM EBCDIC (Icelandic-Euro)
12001200 UTF-16utf-16 UnicodeUnicode
12011201 unicodeFFFEunicodeFFFE Unicode (Big endian)Unicode (Big endian)
12501250 Windows-1250windows-1250 Europe centrale (Windows)Central European (Windows)
12511251 windows-1251windows-1251 Cyrillique (Windows)Cyrillic (Windows)
12521252 Windows-1252Windows-1252 Europe occidentale (Windows)Western European (Windows)
12531253 windows-1253windows-1253 Grec (Windows)Greek (Windows)
12541254 windows-1254windows-1254 Turc (Windows)Turkish (Windows)
12551255 windows-1255windows-1255 Hébreu (Windows)Hebrew (Windows)
12561256 Windows-1256windows-1256 Arabe (Windows)Arabic (Windows)
12571257 windows-1257windows-1257 Balte (Windows)Baltic (Windows)
12581258 windows-1258windows-1258 Vietnamien (Windows)Vietnamese (Windows)
13611361 JohabJohab Coréen (Johab)Korean (Johab)
1000010000 ordinateursmacintosh Europe occidentale (Mac)Western European (Mac)
1000110001 x-Mac-japonaisx-mac-japanese Japonais (Mac)Japanese (Mac)
1000210002 x-mac-chinesetradx-mac-chinesetrad Chinois traditionnel (Mac)Chinese Traditional (Mac)
1000310003 x-Mac-coréenx-mac-korean Coréen (Mac)Korean (Mac)
1000410004 x-Mac-arabex-mac-arabic Arabe (Mac)Arabic (Mac)
1000510005 x-mac-hebrewx-mac-hebrew Hébreu (Mac)Hebrew (Mac)
1000610006 x-Mac-grecx-mac-greek Grec (Mac)Greek (Mac)
1000710007 x-Mac-cyrilliquex-mac-cyrillic Cyrillique (Mac)Cyrillic (Mac)
1000810008 x-mac-chinesesimpx-mac-chinesesimp Chinois simplifié (Mac)Chinese Simplified (Mac)
1001010010 x-Mac-roumainx-mac-romanian Roumain (Mac)Romanian (Mac)
1001710017 x-Mac-ukrainienx-mac-ukrainian Ukrainien (Mac)Ukrainian (Mac)
1002110021 x-Mac-thaïx-mac-thai Thaï (Mac)Thai (Mac)
1002910029 x-Mac-cex-mac-ce Europe centrale (Mac)Central European (Mac)
1007910079 x-Mac-islandaisx-mac-icelandic Islandais (Mac)Icelandic (Mac)
1008110081 x-Mac-turcx-mac-turkish Turc (Mac)Turkish (Mac)
1008210082 x-Mac-croatex-mac-croatian Croate (Mac)Croatian (Mac)
1200012000 UTF-32utf-32 Unicode (UTF-32)Unicode (UTF-32)
1200112001 UTF-32BEutf-32BE Unicode (UTF-32 Big endian)Unicode (UTF-32 Big endian)
2000020000 x-chinois-CNSx-Chinese-CNS Chinois traditionnel (CNS)Chinese Traditional (CNS)
2000120001 x-cp20001x-cp20001 TCA TaïwanTCA Taiwan
2000220002 x-chinois-eTENx-Chinese-Eten Chinois traditionnel (eten)Chinese Traditional (Eten)
2000320003 x-cp20003x-cp20003 IBM5550 TaiwanIBM5550 Taiwan
2000420004 x-cp20004x-cp20004 Teletext TaïwanTeleText Taiwan
2000520005 x-cp20005x-cp20005 Taïwan WangWang Taiwan
2010520105 x-IA5x-IA5 Europe occidentale (IA5)Western European (IA5)
2010620106 x-IA5-allemandx-IA5-German Allemand (IA5)German (IA5)
2010720107 x-IA5-suédoisx-IA5-Swedish Suédois (IA5)Swedish (IA5)
2010820108 x-IA5-norvégienx-IA5-Norwegian Norvégien (IA5)Norwegian (IA5)
2012720127 US-ASCIIus-ascii US-ASCIIUS-ASCII
2026120261 x-cp20261x-cp20261 T. 61T.61
2026920269 x-cp20269x-cp20269 ISO-6937ISO-6937
2027320273 IBM273IBM273 IBM EBCDIC (Allemagne)IBM EBCDIC (Germany)
2027720277 IBM277IBM277 IBM EBCDIC (Danemark-Norvège)IBM EBCDIC (Denmark-Norway)
2027820278 IBM278IBM278 IBM EBCDIC (Finlande-Suède)IBM EBCDIC (Finland-Sweden)
2028020280 IBM280IBM280 IBM EBCDIC (Italie)IBM EBCDIC (Italy)
2028420284 IBM284IBM284 IBM EBCDIC (Espagne)IBM EBCDIC (Spain)
2028520285 IBM285IBM285 IBM EBCDIC (ROYAUME-UNI)IBM EBCDIC (UK)
2029020290 IBM290IBM290 IBM EBCDIC (japonais Katakana)IBM EBCDIC (Japanese katakana)
2029720297 IBM297IBM297 IBM EBCDIC (France)IBM EBCDIC (France)
2042020420 IBM420IBM420 IBM EBCDIC (arabe)IBM EBCDIC (Arabic)
2042320423 IBM423IBM423 IBM EBCDIC (grec)IBM EBCDIC (Greek)
2042420424 IBM424IBM424 IBM EBCDIC (hébreu)IBM EBCDIC (Hebrew)
2083320833 x-EBCDIC-KoreanExtendedx-EBCDIC-KoreanExtended IBM EBCDIC (coréen étendu)IBM EBCDIC (Korean Extended)
2083820838 IBM-thaïIBM-Thai IBM EBCDIC (thaï)IBM EBCDIC (Thai)
2086620866 koi8-rkoi8-r Cyrillique (KOI8-R)Cyrillic (KOI8-R)
2087120871 IBM871IBM871 IBM EBCDIC (islandais)IBM EBCDIC (Icelandic)
2088020880 IBM880IBM880 IBM EBCDIC (russe cyrillique)IBM EBCDIC (Cyrillic Russian)
2090520905 IBM905IBM905 IBM EBCDIC (turc)IBM EBCDIC (Turkish)
2092420924 IBM00924IBM00924 IBM latin-1IBM Latin-1
2093220932 EUC-JPEUC-JP Japonais (JIS 0208-1990 et 0212-1990)Japanese (JIS 0208-1990 and 0212-1990)
2093620936 x-cp20936x-cp20936 Chinois simplifié (GB2312-80)Chinese Simplified (GB2312-80)
2094920949 x-cp20949x-cp20949 Wansung coréenKorean Wansung
2102521025 cp1025cp1025 IBM EBCDIC (serbe cyrillique-bulgare)IBM EBCDIC (Cyrillic Serbian-Bulgarian)
2186621866 koi8-ukoi8-u Cyrillique (KOI8-U)Cyrillic (KOI8-U)
2859128591 iso-8859-1iso-8859-1 Europe occidentale (ISO)Western European (ISO)
2859228592 iso-8859-2iso-8859-2 Europe centrale (ISO)Central European (ISO)
2859328593 iso-8859-3iso-8859-3 Latin 3 (ISO)Latin 3 (ISO)
2859428594 iso-8859-4iso-8859-4 Balte (ISO)Baltic (ISO)
2859528595 iso-8859-5iso-8859-5 Cyrillique (ISO)Cyrillic (ISO)
2859628596 iso-8859-6iso-8859-6 Arabe (ISO)Arabic (ISO)
2859728597 iso-8859-7iso-8859-7 Grec (ISO)Greek (ISO)
2859828598 iso-8859-8iso-8859-8 Hébreu (ISO-Visual)Hebrew (ISO-Visual)
2859928599 iso-8859-9iso-8859-9 Turc (ISO)Turkish (ISO)
2860328603 iso-8859-13iso-8859-13 Estonien (ISO)Estonian (ISO)
2860528605 iso-8859-15iso-8859-15 Latin 9 (ISO)Latin 9 (ISO)
2900129001 x-Europax-Europa EuropaEuropa
3859838598 iso-8859-8-iiso-8859-8-i Hébreu (ISO-Logical)Hebrew (ISO-Logical)
5022050220 ISO-2022-JPiso-2022-jp Japonais (JIS)Japanese (JIS)
5022150221 csISO2022JPcsISO2022JP Japanese (JIS-autoriser les caractères Kana de 1 octet)Japanese (JIS-Allow 1 byte Kana)
5022250222 ISO-2022-JPiso-2022-jp Japanese (JIS-autoriser les caractères Kana à 1 octet-SO/SI)Japanese (JIS-Allow 1 byte Kana - SO/SI)
5022550225 ISO-2022-KRiso-2022-kr Coréen (ISO)Korean (ISO)
5022750227 x-cp50227x-cp50227 Chinois simplifié (ISO-2022)Chinese Simplified (ISO-2022)
5193251932 EUC-JPeuc-jp Japonais (EUC)Japanese (EUC)
5193651936 EUC-CNEUC-CN Chinois simplifié (EUC)Chinese Simplified (EUC)
5194951949 EUC-KReuc-kr Coréen (EUC)Korean (EUC)
5293652936 hz-gb-2312hz-gb-2312 Chinois simplifié (HZ)Chinese Simplified (HZ)
5493654936 GB18030GB18030 Chinois simplifié (GB18030)Chinese Simplified (GB18030)
5700257002 x-iscii-dex-iscii-de ISCII DÉVANÂGARÎISCII Devanagari
5700357003 x-ISCII-estx-iscii-be Bengali ISCIIISCII Bengali
5700457004 x-iscii-tax-iscii-ta Tamoul ISCIIISCII Tamil
5700557005 x-ISCII-tex-iscii-te Telugu ISCIIISCII Telugu
5700657006 x-ISCII-Asx-iscii-as ISCII assamaisISCII Assamese
5700757007 x-ISCII-orx-iscii-or Oriya ISCIIISCII Oriya
5700857008 x-iscii-kax-iscii-ka Kannada ISCIIISCII Kannada
5700957009 x-iscii-max-iscii-ma Malayalam ISCIIISCII Malayalam
5701057010 x-ISCII-Gux-iscii-gu Gujarati ISCIIISCII Gujarati
5701157011 x-ISCII-PAx-iscii-pa Pendjabi ISCIIISCII Punjabi
6500065000 utf-7utf-7 Unicode (UTF-7)Unicode (UTF-7)
6500165001 utf-8utf-8 Unicode (UTF-8)Unicode (UTF-8)

L’exemple suivant appelle les GetEncoding(Int32) méthodes GetEncoding(String) et pour récupérer l’encodage de page de codes grec (Windows).The following example calls the GetEncoding(Int32) and GetEncoding(String) methods to get the Greek (Windows) code page encoding. Il compare les Encoding objets retournés par les appels de méthode pour montrer qu’ils sont égaux, puis Maps affiche le point de code Unicode et la valeur de page de codes correspondante pour chaque caractère de l’alphabet grec.It compares the Encoding objects returned by the method calls to show that they are equal, and then maps displays the Unicode code point and the corresponding code page value for each character in the Greek alphabet.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding enc = Encoding.GetEncoding(1253);
      Encoding altEnc = Encoding.GetEncoding("windows-1253");
      Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
                        altEnc.CodePage, enc.Equals(altEnc));
      string greekAlphabet = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
                             "Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
                             "Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
                             "Φ φ Χ χ Ψ ψ Ω ω";
      Console.OutputEncoding = Encoding.UTF8;
      byte[] bytes = enc.GetBytes(greekAlphabet);
      Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
                        "Unicode Code Point", "Code Page 1253");
      for (int ctr = 0; ctr < bytes.Length; ctr++) {
         if (greekAlphabet[ctr].Equals(' '))
            continue;

         Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet[ctr],
                           GetCodePoint(greekAlphabet[ctr]), bytes[ctr]);
      }
   }

   private static string GetCodePoint(char ch)
   {
      string retVal = "u+";
      byte[] bytes = Encoding.Unicode.GetBytes(ch.ToString());
      for (int ctr = bytes.Length - 1; ctr >= 0; ctr--)
         retVal += bytes[ctr].ToString("X2");

      return retVal;
   }
}
// The example displays the following output:
//       Character      Unicode Code Point       Code Page 1253
//       Α                          u+0391                   C1
//       α                          u+03B1                   E1
//       Β                          u+0392                   C2
//       β                          u+03B2                   E2
//       Γ                          u+0393                   C3
//       γ                          u+03B3                   E3
//       Δ                          u+0394                   C4
//       δ                          u+03B4                   E4
//       Ε                          u+0395                   C5
//       ε                          u+03B5                   E5
//       Ζ                          u+0396                   C6
//       ζ                          u+03B6                   E6
//       Η                          u+0397                   C7
//       η                          u+03B7                   E7
//       Θ                          u+0398                   C8
//       θ                          u+03B8                   E8
//       Ι                          u+0399                   C9
//       ι                          u+03B9                   E9
//       Κ                          u+039A                   CA
//       κ                          u+03BA                   EA
//       Λ                          u+039B                   CB
//       λ                          u+03BB                   EB
//       Μ                          u+039C                   CC
//       μ                          u+03BC                   EC
//       Ν                          u+039D                   CD
//       ν                          u+03BD                   ED
//       Ξ                          u+039E                   CE
//       ξ                          u+03BE                   EE
//       Ο                          u+039F                   CF
//       ο                          u+03BF                   EF
//       Π                          u+03A0                   D0
//       π                          u+03C0                   F0
//       Ρ                          u+03A1                   D1
//       ρ                          u+03C1                   F1
//       Σ                          u+03A3                   D3
//       σ                          u+03C3                   F3
//       ς                          u+03C2                   F2
//       Τ                          u+03A4                   D4
//       τ                          u+03C4                   F4
//       Υ                          u+03A5                   D5
//       υ                          u+03C5                   F5
//       Φ                          u+03A6                   D6
//       φ                          u+03C6                   F6
//       Χ                          u+03A7                   D7
//       χ                          u+03C7                   F7
//       Ψ                          u+03A8                   D8
//       ψ                          u+03C8                   F8
//       Ω                          u+03A9                   D9
//       ω                          u+03C9                   F9
Imports System.Text

Module Example
   Public Sub Main()
      Dim enc As Encoding = Encoding.GetEncoding(1253)
      Dim altEnc As Encoding = Encoding.GetEncoding("windows-1253")
      Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
                        altEnc.CodePage, enc.Equals(altEnc))
      Dim greekAlphabet As String = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
                                    "Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
                                    "Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
                                    "Φ φ Χ χ Ψ ψ Ω ω"
      Console.OutputEncoding = Encoding.UTF8
      Dim bytes() As Byte = enc.GetBytes(greekAlphabet)
      Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
                        "Unicode Code Point", "Code Page 1253")
      For ctr As Integer = 0 To bytes.Length - 1
         If greekAlphabet(ctr).Equals(" "c) Then Continue For

         Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet(ctr),
                           GetCodePoint(greekAlphabet(ctr)), bytes(ctr))
      Next

   End Sub
   
   Private Function GetCodePoint(ch As String) As String
      Dim retVal As String = "u+"
      Dim bytes() As Byte = Encoding.Unicode.GetBytes(ch)
      For ctr As Integer = bytes.Length - 1 To 0 Step -1
         retVal += bytes(ctr).ToString("X2")
      Next
      Return retVal
   End Function
End Module
' The example displays the following output:
'    Character      Unicode Code Point       Code Page 1253
'    Α                          u+0391                   C1
'    α                          u+03B1                   E1
'    Β                          u+0392                   C2
'    β                          u+03B2                   E2
'    Γ                          u+0393                   C3
'    γ                          u+03B3                   E3
'    Δ                          u+0394                   C4
'    δ                          u+03B4                   E4
'    Ε                          u+0395                   C5
'    ε                          u+03B5                   E5
'    Ζ                          u+0396                   C6
'    ζ                          u+03B6                   E6
'    Η                          u+0397                   C7
'    η                          u+03B7                   E7
'    Θ                          u+0398                   C8
'    θ                          u+03B8                   E8
'    Ι                          u+0399                   C9
'    ι                          u+03B9                   E9
'    Κ                          u+039A                   CA
'    κ                          u+03BA                   EA
'    Λ                          u+039B                   CB
'    λ                          u+03BB                   EB
'    Μ                          u+039C                   CC
'    μ                          u+03BC                   EC
'    Ν                          u+039D                   CD
'    ν                          u+03BD                   ED
'    Ξ                          u+039E                   CE
'    ξ                          u+03BE                   EE
'    Ο                          u+039F                   CF
'    ο                          u+03BF                   EF
'    Π                          u+03A0                   D0
'    π                          u+03C0                   F0
'    Ρ                          u+03A1                   D1
'    ρ                          u+03C1                   F1
'    Σ                          u+03A3                   D3
'    σ                          u+03C3                   F3
'    ς                          u+03C2                   F2
'    Τ                          u+03A4                   D4
'    τ                          u+03C4                   F4
'    Υ                          u+03A5                   D5
'    υ                          u+03C5                   F5
'    Φ                          u+03A6                   D6
'    φ                          u+03C6                   F6
'    Χ                          u+03A7                   D7
'    χ                          u+03C7                   F7
'    Ψ                          u+03A8                   D8
'    ψ                          u+03C8                   F8
'    Ω                          u+03A9                   D9
'    ω                          u+03C9                   F9

Si les données à convertir sont uniquement disponibles dans des blocs séquentiels (par exemple, les données lues à partir d’un flux) ou si la quantité de données est tellement importante qu’elles doivent être divisées en blocs Decoder plus petits Encoder , vous devez GetDecoder utiliser le ou le fourni par le méthode ou GetEncoder méthode, respectivement, d’une classe dérivée.If the data to be converted is available only in sequential blocks (such as data read from a stream) or if the amount of data is so large that it needs to be divided into smaller blocks, you should use the Decoder or the Encoder provided by the GetDecoder method or the GetEncoder method, respectively, of a derived class.

Les encodeurs UTF-16 et UTF-32 peuvent utiliser l’ordre d’octet de poids fort (octet le plus significatif en premier) ou l’ordre de primauté des octets de poids faible (octet le moins significatif en premier).The UTF-16 and the UTF-32 encoders can use the big endian byte order (most significant byte first) or the little endian byte order (least significant byte first). Par exemple, la lettre majuscule latine A (U + 0041) est sérialisée comme suit (au format hexadécimal) :For example, the Latin Capital Letter A (U+0041) is serialized as follows (in hexadecimal):

  • Ordre d’octet UTF-16 Big endian : 00 41UTF-16 big endian byte order: 00 41

  • Ordre d’octet UTF-16 Little endian : 41 00UTF-16 little endian byte order: 41 00

  • Ordre d’octet UTF-32 Big endian : 00 00 00 41UTF-32 big endian byte order: 00 00 00 41

  • Ordre d’octet UTF-32 Little endian : 41 00 00 00UTF-32 little endian byte order: 41 00 00 00

Il est généralement plus efficace de stocker des caractères Unicode à l’aide de l’ordre d’octet natif.It is generally more efficient to store Unicode characters using the native byte order. Par exemple, il est préférable d’utiliser l’ordre d’octet avec primauté des octets de poids faible sur les plateformes Little endian, comme les ordinateurs Intel.For example, it is better to use the little endian byte order on little endian platforms, such as Intel computers.

La GetPreamble méthode récupère un tableau d’octets qui comprend la marque d’ordre d’octet (BOM).The GetPreamble method retrieves an array of bytes that includes the byte order mark (BOM). Si ce tableau d’octets est préfixé à un flux encodé, il aide le décodeur à identifier le format d’encodage utilisé.If this byte array is prefixed to an encoded stream, it helps the decoder to identify the encoding format used.

Pour plus d’informations sur l’ordre d’octet et la marque d’ordre d’octet, consultez la norme Unicode sur la page d’hébergement Unicode.For more information on byte order and the byte order mark, see The Unicode Standard at the Unicode home page.

Notez que les classes d’encodage autorisent les erreurs à :Note that the encoding classes allow errors to:

  • Passez en mode silencieux à un caractère «  ? ».Silently change to a "?" character.

  • Utilisez un caractère « ajuster ».Use a "best fit" character.

  • Passez à un comportement spécifique à l’application par le biais EncoderFallback de DecoderFallback l’utilisation des classes et avec le caractère de remplacement Unicode U + FFFD.Change to an application-specific behavior through use of the EncoderFallback and DecoderFallback classes with the U+FFFD Unicode replacement character.

Vous devez lever une exception en cas d’erreur de flux de données.You should throw an exception on any data stream error. Une application utilise un indicateur « throwOnError » le cas échéant, ou utilise EncoderExceptionFallback les DecoderExceptionFallback classes et.An app either uses a "throwonerror" flag when applicable or uses the EncoderExceptionFallback and DecoderExceptionFallback classes. L’option de secours la mieux adaptée est souvent déconseillée, car elle peut entraîner une perte de données ou une confusion et est plus lente que les remplacements de caractères simples.Best fit fallback is often not recommended because it can cause data loss or confusion and is slower than simple character replacements. Pour les encodages ANSI, le comportement le mieux adapté est le comportement par défaut.For ANSI encodings, the best fit behavior is the default.

Constructeurs

Encoding() Encoding() Encoding() Encoding()

Initialise une nouvelle instance de la classe Encoding.Initializes a new instance of the Encoding class.

Encoding(Int32) Encoding(Int32) Encoding(Int32) Encoding(Int32)

Initialise une nouvelle instance de la classe Encoding qui correspond à la page de codes spécifiée.Initializes a new instance of the Encoding class that corresponds to the specified code page.

Encoding(Int32, EncoderFallback, DecoderFallback) Encoding(Int32, EncoderFallback, DecoderFallback) Encoding(Int32, EncoderFallback, DecoderFallback) 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.Initializes a new instance of the Encoding class that corresponds to the specified code page with the specified encoder and decoder fallback strategies.

Propriétés

ASCII ASCII ASCII ASCII

Obtient un encodage pour le jeu de caractères ASCII (7 bits).Gets an encoding for the ASCII (7-bit) character set.

BigEndianUnicode BigEndianUnicode BigEndianUnicode BigEndianUnicode

Obtient un encodage pour le format UTF-16 qui utilise l'ordre d'octet avec primauté des octets de poids fort (big-endian).Gets an encoding for the UTF-16 format that uses the big endian byte order.

BodyName BodyName BodyName 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.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent body tags.

CodePage CodePage CodePage CodePage

En cas de substitution dans une classe dérivée, obtient l'identificateur de la page de codes du Encoding actuel.When overridden in a derived class, gets the code page identifier of the current Encoding.

DecoderFallback DecoderFallback DecoderFallback DecoderFallback

Obtient ou définit l'objet DecoderFallback actuel de l'objet Encoding actuel.Gets or sets the DecoderFallback object for the current Encoding object.

Default Default Default Default

Obtient l’encodage par défaut pour cette implémentation .NET.Gets the default encoding for this .NET implementation.

EncoderFallback EncoderFallback EncoderFallback EncoderFallback

Obtient ou définit l'objet EncoderFallback actuel de l'objet Encoding actuel.Gets or sets the EncoderFallback object for the current Encoding object.

EncodingName EncodingName EncodingName EncodingName

En cas de substitution dans une classe dérivée, obtient la description explicite de l'encodage actuel.When overridden in a derived class, gets the human-readable description of the current encoding.

HeaderName HeaderName HeaderName 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.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent header tags.

IsBrowserDisplay IsBrowserDisplay IsBrowserDisplay 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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for displaying content.

IsBrowserSave IsBrowserSave IsBrowserSave 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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for saving content.

IsMailNewsDisplay IsMailNewsDisplay IsMailNewsDisplay 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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for displaying content.

IsMailNewsSave IsMailNewsSave IsMailNewsSave 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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for saving content.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

En cas de substitution dans une classe dérivée, obtient une valeur indiquant si l'encodage actuel est en lecture seule.When overridden in a derived class, gets a value indicating whether the current encoding is read-only.

IsSingleByte IsSingleByte IsSingleByte 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.When overridden in a derived class, gets a value indicating whether the current encoding uses single-byte code points.

Preamble Preamble Preamble Preamble
Unicode Unicode Unicode Unicode

Obtient un encodage pour le format UTF-16 avec primauté des octets de poids faible (little-endian).Gets an encoding for the UTF-16 format using the little endian byte order.

UTF32 UTF32 UTF32 UTF32

Obtient un encodage pour le format UTF-32 avec primauté des octets de poids faible (little-endian).Gets an encoding for the UTF-32 format using the little endian byte order.

UTF7 UTF7 UTF7 UTF7

Obtient un encodage pour le format UTF-7.Gets an encoding for the UTF-7 format.

UTF8 UTF8 UTF8 UTF8

Obtient un encodage pour le format UTF-8.Gets an encoding for the UTF-8 format.

WebName WebName WebName 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.When overridden in a derived class, gets the name registered with the Internet Assigned Numbers Authority (IANA) for the current encoding.

WindowsCodePage WindowsCodePage WindowsCodePage 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.When overridden in a derived class, gets the Windows operating system code page that most closely corresponds to the current encoding.

Méthodes

Clone() Clone() Clone() Clone()

En cas de substitution dans une classe dérivée, crée une copie superficielle de l'objet Encoding actuel.When overridden in a derived class, creates a shallow copy of the current Encoding object.

Convert(Encoding, Encoding, Byte[]) Convert(Encoding, Encoding, Byte[]) Convert(Encoding, Encoding, Byte[]) Convert(Encoding, Encoding, Byte[])

Convertit un tableau d'octets entier d'un encodage à un autre.Converts an entire byte array from one encoding to another.

Convert(Encoding, Encoding, Byte[], Int32, Int32) Convert(Encoding, Encoding, Byte[], Int32, Int32) Convert(Encoding, Encoding, Byte[], Int32, Int32) Convert(Encoding, Encoding, Byte[], Int32, Int32)

Convertit une plage d'octets d'un encodage à un autre dans un tableau d'octets.Converts a range of bytes in a byte array from one encoding to another.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si le Object spécifié est égal à l'instance actuelle.Determines whether the specified Object is equal to the current instance.

GetByteCount(Char*, Int32) GetByteCount(Char*, Int32) GetByteCount(Char*, Int32) 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é.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

GetByteCount(Char[]) GetByteCount(Char[]) GetByteCount(Char[]) 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é.When overridden in a derived class, calculates the number of bytes produced by encoding all the characters in the specified character array.

GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) 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é.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified character array.

GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>)
GetByteCount(String) GetByteCount(String) GetByteCount(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 de la chaîne spécifiée.When overridden in a derived class, calculates the number of bytes produced by encoding the characters in the specified string.

GetByteCount(String, Int32, Int32) GetByteCount(String, Int32, Int32) GetByteCount(String, Int32, Int32) GetByteCount(String, Int32, Int32)
GetBytes(Char*, Int32, Byte*, Int32) GetBytes(Char*, Int32, Byte*, Int32) GetBytes(Char*, Int32, Byte*, Int32) 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 séquence d'octets stockés à partir du pointeur d'octet spécifié.When overridden in a derived class, encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

GetBytes(Char[]) GetBytes(Char[]) GetBytes(Char[]) 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 séquence d'octets.When overridden in a derived class, encodes all the characters in the specified character array into a sequence of bytes.

GetBytes(Char[], Int32, Int32) GetBytes(Char[], Int32, Int32) GetBytes(Char[], Int32, Int32) 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 séquence d'octets.When overridden in a derived class, encodes a set of characters from the specified character array into a sequence of bytes.

GetBytes(Char[], Int32, Int32, Byte[], Int32) GetBytes(Char[], Int32, Int32, Byte[], Int32) GetBytes(Char[], Int32, Int32, Byte[], Int32) 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.When overridden in a derived class, encodes a set of characters from the specified character array into the specified byte array.

GetBytes(ReadOnlySpan<Char>, Span<Byte>) GetBytes(ReadOnlySpan<Char>, Span<Byte>) GetBytes(ReadOnlySpan<Char>, Span<Byte>) GetBytes(ReadOnlySpan<Char>, Span<Byte>)
GetBytes(String) GetBytes(String) GetBytes(String) 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 séquence d'octets.When overridden in a derived class, encodes all the characters in the specified string into a sequence of bytes.

GetBytes(String, Int32, Int32) GetBytes(String, Int32, Int32) GetBytes(String, Int32, Int32) GetBytes(String, Int32, Int32)
GetBytes(String, Int32, Int32, Byte[], Int32) GetBytes(String, Int32, Int32, Byte[], Int32) GetBytes(String, Int32, Int32, Byte[], Int32) 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é.When overridden in a derived class, encodes a set of characters from the specified string into the specified byte array.

GetCharCount(Byte*, Int32) GetCharCount(Byte*, Int32) GetCharCount(Byte*, Int32) 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é.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

GetCharCount(Byte[]) GetCharCount(Byte[]) GetCharCount(Byte[]) 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é.When overridden in a derived class, calculates the number of characters produced by decoding all the bytes in the specified byte array.

GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32) 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é.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

GetCharCount(ReadOnlySpan<Byte>) GetCharCount(ReadOnlySpan<Byte>) GetCharCount(ReadOnlySpan<Byte>) GetCharCount(ReadOnlySpan<Byte>)
GetChars(Byte*, Int32, Char*, Int32) GetChars(Byte*, Int32, Char*, Int32) GetChars(Byte*, Int32, Char*, Int32) 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 jeu de caractères stockés à partir du pointeur de caractère spécifié.When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

GetChars(Byte[]) GetChars(Byte[]) GetChars(Byte[]) 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.When overridden in a derived class, decodes all the bytes in the specified byte array into a set of characters.

GetChars(Byte[], Int32, Int32) GetChars(Byte[], Int32, Int32) GetChars(Byte[], Int32, Int32) 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 jeu de caractères.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a set of characters.

GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) 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é.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into the specified character array.

GetChars(ReadOnlySpan<Byte>, Span<Char>) GetChars(ReadOnlySpan<Byte>, Span<Char>) GetChars(ReadOnlySpan<Byte>, Span<Char>) GetChars(ReadOnlySpan<Byte>, Span<Char>)
GetDecoder() GetDecoder() GetDecoder() 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.When overridden in a derived class, obtains a decoder that converts an encoded sequence of bytes into a sequence of characters.

GetEncoder() GetEncoder() GetEncoder() 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.When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.

GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Retourne l'encodage associé à l'identificateur de page de codes spécifié.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Retourne l'encodage associé à l'identificateur de page de codes spécifié.Returns the encoding associated with the specified code page identifier. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Retourne l'encodage associé au nom de la page de codes spécifiée.Returns the encoding associated with the specified code page name.

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Retourne l'encodage associé au nom de la page de codes spécifiée.Returns the encoding associated with the specified code page name. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncodings() GetEncodings() GetEncodings() GetEncodings()

Retourne un tableau qui contient tous les encodages.Returns an array that contains all encodings.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage pour l'instance actuelle.Returns the hash code for the current instance.

GetMaxByteCount(Int32) GetMaxByteCount(Int32) GetMaxByteCount(Int32) 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é.When overridden in a derived class, calculates the maximum number of bytes produced by encoding the specified number of characters.

GetMaxCharCount(Int32) GetMaxCharCount(Int32) GetMaxCharCount(Int32) 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é.When overridden in a derived class, calculates the maximum number of characters produced by decoding the specified number of bytes.

GetPreamble() GetPreamble() GetPreamble() GetPreamble()

En cas de substitution dans une classe dérivée, retourne une séquence d'octets qui spécifie l'encodage utilisé.When overridden in a derived class, returns a sequence of bytes that specifies the encoding used.

GetString(Byte*, Int32) GetString(Byte*, Int32) GetString(Byte*, Int32) 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.When overridden in a derived class, decodes a specified number of bytes starting at a specified address into a string.

GetString(Byte[]) GetString(Byte[]) GetString(Byte[]) 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.When overridden in a derived class, decodes all the bytes in the specified byte array into a string.

GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) 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.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a string.

GetString(ReadOnlySpan<Byte>) GetString(ReadOnlySpan<Byte>) GetString(ReadOnlySpan<Byte>) GetString(ReadOnlySpan<Byte>)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
IsAlwaysNormalized() IsAlwaysNormalized() IsAlwaysNormalized() IsAlwaysNormalized()

Obtient une valeur indiquant si l'encodage actuel est toujours normalisé en utilisant le formulaire de normalisation par défaut.Gets a value indicating whether the current encoding is always normalized, using the default normalization form.

IsAlwaysNormalized(NormalizationForm) IsAlwaysNormalized(NormalizationForm) IsAlwaysNormalized(NormalizationForm) 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é.When overridden in a derived class, gets a value indicating whether the current encoding is always normalized, using the specified normalization form.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
RegisterProvider(EncodingProvider) RegisterProvider(EncodingProvider) RegisterProvider(EncodingProvider) RegisterProvider(EncodingProvider)

Enregistre un fournisseur d'encodage.Registers an encoding provider.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à

Voir aussi