UnicodeEncoding Constructeurs

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.

Initialise une nouvelle instance de la classe UnicodeEncoding.

Surcharges

Nom	Description
UnicodeEncoding()	Initialise une nouvelle instance de la classe UnicodeEncoding.
UnicodeEncoding(Boolean, Boolean)	Initialise une nouvelle instance de la classe UnicodeEncoding. Les paramètres spécifient s’il faut utiliser l’ordre des octets big endian et si la GetPreamble() méthode retourne une marque d’ordre d’octet Unicode.
UnicodeEncoding(Boolean, Boolean, Boolean)	Initialise une nouvelle instance de la classe UnicodeEncoding. Les paramètres spécifient s’il faut utiliser l’ordre d’octet big endian, s’il faut fournir une marque d’ordre d’octet Unicode et s’il faut lever une exception lorsqu’un encodage non valide est détecté.

UnicodeEncoding()

Initialise une nouvelle instance de la classe UnicodeEncoding.

public:
 UnicodeEncoding();

public UnicodeEncoding();

Public Sub New ()

Exemples

L’exemple suivant montre comment créer une instance UnicodeEncoding et afficher le nom de l’encodage.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        UnicodeEncoding unicode = new UnicodeEncoding();
        String encodingName = unicode.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

Imports System.Text

Class UnicodeEncodingExample

    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim encodingName As String = uni.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

Remarques

Ce constructeur crée une instance qui utilise l’ordre d’octets little endian, fournit une marque d’ordre d’octet Unicode et ne lève pas d’exception lorsqu’un encodage non valide est détecté.

Avertissement

Pour des raisons de sécurité, vous devez activer la détection des erreurs en appelant le UnicodeEncoding(Boolean, Boolean, Boolean) constructeur et en définissant son throwOnInvalidBytes argument sur true.

S’applique à

UnicodeEncoding(Boolean, Boolean)

Initialise une nouvelle instance de la classe UnicodeEncoding. Les paramètres spécifient s’il faut utiliser l’ordre des octets big endian et si la GetPreamble() méthode retourne une marque d’ordre d’octet Unicode.

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark);

public UnicodeEncoding(bool bigEndian, bool byteOrderMark);

new System.Text.UnicodeEncoding : bool * bool -> System.Text.UnicodeEncoding

Public Sub New (bigEndian As Boolean, byteOrderMark As Boolean)

Paramètres

bigEndian: Boolean

true pour utiliser l’ordre d’octets big endian (octet le plus significatif en premier) ou false pour utiliser l’ordre d’octets du petit endian (octet le moins significatif en premier).

byteOrderMark: Boolean

true pour spécifier que la GetPreamble() méthode retourne une marque d’ordre d’octet Unicode ; sinon, false.

Exemples

L’exemple suivant montre comment créer une nouvelle UnicodeEncoding instance spécifiant s’il faut prendre en charge l’ordre des octets de petite fin ou big endian et la marque d’ordre d’octet Unicode.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {

        // Create a UnicodeEncoding without parameters.
        UnicodeEncoding unicode = new UnicodeEncoding();

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianBOM = 
            new UnicodeEncoding(false, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianBOM));

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianNoBOM =
            new UnicodeEncoding(false, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianNoBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianBOM =
            new UnicodeEncoding(true, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianNoBOM =
            new UnicodeEncoding(true, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianNoBOM));
    }

    public static void DescribeEquivalence(Boolean isEquivalent) {
        Console.WriteLine(
            "{0} equivalent encoding.", (isEquivalent ? "An" : "Not an")
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()

        ' Create a UnicodeEncoding without parameters.
        Dim unicodeDefault As New UnicodeEncoding()

        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and include the Unicode byte order mark.        
        Dim unicodeLittleEndianBOM As New UnicodeEncoding(False, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianBOM))
        
        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeLittleEndianNoBOM As New UnicodeEncoding(False, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianNoBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and include the Unicode byte order mark.
        Dim unicodeBigEndianBOM As New UnicodeEncoding(True, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeBigEndianNoBOM As New UnicodeEncoding(True, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianNoBOM))
    End Sub
    
    
    Public Shared Sub DescribeEquivalence(isEquivalent As Boolean)
        Dim phrase as String
        If isEquivalent Then
            phrase = "An"
        Else
            phrase = "Not an"
        End If
        Console.WriteLine("{0} equivalent encoding.", phrase)
    End Sub
End Class

Remarques

Ce constructeur crée une instance qui ne lève pas d’exception lorsqu’un encodage non valide est détecté.

Avertissement

Le byteOrderMark paramètre contrôle l’opération de la GetPreamble méthode. Si true, la méthode retourne un tableau d’octets contenant la marque d’ordre d’octet Unicode (BOM) au format UTF-16. Si false, elle retourne un tableau d’octets de longueur nulle. Toutefois, le paramètre byteOrderMark à true ne provoque pas le préfixe de la GetBytes méthode au début du tableau d’octets, ni n’entraîne-t-il GetByteCount l’ajout du nombre d’octets dans le nombre d’octets dans le nombre d’octets.

Voir aussi

GetPreamble()

S’applique à

UnicodeEncoding(Boolean, Boolean, Boolean)

Initialise une nouvelle instance de la classe UnicodeEncoding. Les paramètres spécifient s’il faut utiliser l’ordre d’octet big endian, s’il faut fournir une marque d’ordre d’octet Unicode et s’il faut lever une exception lorsqu’un encodage non valide est détecté.

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark, bool throwOnInvalidBytes);

public UnicodeEncoding(bool bigEndian, bool byteOrderMark, bool throwOnInvalidBytes);

new System.Text.UnicodeEncoding : bool * bool * bool -> System.Text.UnicodeEncoding

Public Sub New (bigEndian As Boolean, byteOrderMark As Boolean, throwOnInvalidBytes As Boolean)

Paramètres

bigEndian: Boolean

true pour utiliser l’ordre des octets big endian (octet le plus significatif en premier) ; false pour utiliser l’ordre des octets du petit endian (octet le moins significatif en premier).

byteOrderMark: Boolean

true pour spécifier que la GetPreamble() méthode retourne une marque d’ordre d’octet Unicode ; sinon, false.

throwOnInvalidBytes: Boolean

true pour spécifier qu’une exception doit être levée lorsqu’un encodage non valide est détecté ; sinon, false.

Exemples

L’exemple suivant illustre le comportement de UnicodeEncoding, à la fois avec la détection d’erreur activée et sans.

using System;
using System.Text;

public class SamplesUnicodeEncoding  {

   public static void Main()  {

      // Create an instance of UnicodeEncoding using little-endian byte order.
      // This will be used for encoding.
      UnicodeEncoding u16LE     = new UnicodeEncoding( false, true );

      // Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
      // These will be used for decoding.
      UnicodeEncoding u16withED = new UnicodeEncoding( true, true, true );
      UnicodeEncoding u16noED   = new UnicodeEncoding( true, true, false );

      // Create byte arrays from the same string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    Latin Capital Letter U with  Diaeresis (U+00DC)
      String myStr = "za\u0306\u01FD\u03B2\u00DC";

      // Encode the string using little-endian byte order.
      byte[] myBytes = new byte[u16LE.GetByteCount( myStr )];
      u16LE.GetBytes( myStr, 0, myStr.Length, myBytes, 0 );

      // Decode the byte array with error detection.
      Console.WriteLine( "Decoding with error detection:" );
      PrintDecodedString( myBytes, u16withED );

      // Decode the byte array without error detection.
      Console.WriteLine( "Decoding without error detection:" );
      PrintDecodedString( myBytes, u16noED );
   }

   // Decode the bytes and display the string.
   public static void PrintDecodedString( byte[] bytes, Encoding enc )  {

      try  {
         Console.WriteLine( "   Decoded string: {0}", enc.GetString( bytes, 0, bytes.Length ) );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.ToString() );
      }

      Console.WriteLine();
   }
}

Imports System.Text

Public Class SamplesUnicodeEncoding   

   Public Shared Sub Main()

      ' Create an instance of UnicodeEncoding using little-endian byte order.
      ' This will be used for encoding.
      Dim u16LE As New UnicodeEncoding(False, True)

      ' Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
      ' These will be used for decoding.
      Dim u16withED As New UnicodeEncoding(True, True, True)
      Dim u16noED As New UnicodeEncoding(True, True, False)

      ' Create byte arrays from the same string containing the following characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    Latin Capital Letter U with  Diaeresis (U+00DC)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&H00DC)

      ' Encode the string using little-endian byte order.
      Dim myBytes(u16LE.GetByteCount(myStr)) As Byte
      u16LE.GetBytes(myStr, 0, myStr.Length, myBytes, 0)

      ' Decode the byte array with error detection.
      Console.WriteLine("Decoding with error detection:")
      PrintDecodedString(myBytes, u16withED)

      ' Decode the byte array without error detection.
      Console.WriteLine("Decoding without error detection:")
      PrintDecodedString(myBytes, u16noED)

   End Sub


   ' Decode the bytes and display the string.
   Public Shared Sub PrintDecodedString(bytes() As Byte, enc As Encoding)

      Try
         Console.WriteLine("   Decoded string: {0}", enc.GetString(bytes, 0, bytes.Length))
      Catch e As System.ArgumentException
         Console.WriteLine(e.ToString())
      End Try

      Console.WriteLine()

   End Sub

End Class

Remarques

Si le throwOnInvalidBytes paramètre est true, une méthode qui détecte une séquence d’octets System.ArgumentExceptionnon valide lève . Sinon, la méthode ne lève pas d’exception et la séquence non valide est ignorée.

Avertissement

Pour des raisons de sécurité, vous devez utiliser ce constructeur pour créer une instance de la classe et activer la UnicodeEncoding détection des erreurs en définissant throwOnInvalidBytes sur true.

Voir aussi

GetPreamble()

S’applique à

Commentaires

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