UnicodeEncoding.GetBytes Méthode

  • Référence

Définition

Espace de noms:
System.Text
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Encode un jeu de caractères en une séquence d'octets.

Surcharges

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Encode un jeu de caractères du tableau de caractères spécifié dans le tableau d'octets indiqué.
GetBytes(String, Int32, Int32, Byte[], Int32)

Encode un jeu de caractères de la chaîne String spécifiée dans le tableau d'octets indiqué.
GetBytes(String)

Encode un jeu de caractères de la chaîne spécifiée dans le tableau d’octets indiqué.
GetBytes(Char*, Int32, Byte*, Int32)

Code une séquence de caractères commençant au pointeur de caractère spécifié en une séquence d'octets, qui sera stockée à partir du pointeur d'octet spécifié.

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Encode un jeu de caractères du tableau de caractères spécifié dans le tableau d'octets indiqué.

public:
 override int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : char[] * int * int * byte[] * int -> int
Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Paramètres

chars
Char[]

Tableau de caractères contenant le jeu de caractères à encoder.

charIndex
Int32

Index du premier caractère à encoder.

charCount
Int32

Nombre de caractères à encoder.

bytes
Byte[]

Tableau d'octets destiné à contenir la séquence d'octets obtenue.

byteIndex
Int32

Index auquel commencer l'écriture de la séquence d'octets obtenue.

Retours

Int32

Nombre réel d'octets écrits dans bytes.

Exceptions

ArgumentNullException

chars a la valeur null (Nothing).

  • ou - bytes a la valeur null (Nothing).
ArgumentOutOfRangeException

charIndex, charCount ou byteIndex est inférieur à zéro.

  • ou - charIndex et charCount ne désignent pas une plage valide dans chars.

  • ou - byteIndex n'est pas un index valide dans bytes.

ArgumentException

La détection d’erreurs est activée et chars contient une séquence de caractères non valide.

  • ou - bytes ne possède pas une capacité suffisante entre byteIndex et la fin du tableau pour prendre en charge les octets obtenus.
EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Codage de caractères dans .NET) -et- EncoderFallback a la valeur EncoderExceptionFallback.

Exemples

L’exemple suivant montre comment utiliser la GetBytes méthode pour encoder une plage de caractères à partir d’un String octet et stocker les octets encodés dans une plage d’éléments d’un tableau d’octets.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   String^ chars = "Unicode Encoding Example";
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = Unicode->GetByteCount( chars->ToCharArray(), 8, 8 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = Unicode->GetBytes( chars, 8, 8, bytes, 0 );
   Console::WriteLine( "{0} bytes used to encode string.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "Unicode Encoding Example";
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars.ToCharArray(), 8, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 8, 8, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode string.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "Unicode Encoding Example"
        
        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars.ToCharArray(), 8, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 8, 8, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode string.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Remarques

Pour calculer la taille exacte du tableau requise pour GetBytes stocker les octets résultants, vous appelez la GetByteCount méthode. Pour calculer la taille maximale du tableau, vous appelez la GetMaxByteCount méthode. La GetByteCount méthode alloue généralement moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Avec la détection d’erreur, une séquence non valide entraîne la levée d’une ArgumentExceptionméthode . Sans détection d’erreur, les séquences non valides sont ignorées et aucune exception n’est levée.

Les données à convertir, telles que les données lues à partir d’un flux, peuvent être disponibles uniquement dans des blocs séquentiels. Dans ce cas, ou si la quantité de données est si importante qu’elle doit être divisée en blocs plus petits, l’application doit utiliser respectivement la Decoder GetDecoder méthode ou GetEncoder la Encoder méthode fournie.

Important

Pour vous assurer que les octets encodés sont correctement décodés lorsqu’ils sont enregistrés en tant que fichier ou en tant que flux, vous pouvez préfixer un flux d’octets encodés avec un préambule. L’insertion du préambule au début d’un flux d’octets (par exemple, au début d’une série d’octets à écrire dans un fichier) est la responsabilité du développeur. La GetBytes méthode n’ajoute pas de préambule au début d’une séquence d’octets encodés.

Voir aussi

S’applique à

GetBytes(String, Int32, Int32, Byte[], Int32)

Encode un jeu de caractères de la chaîne String spécifiée dans le tableau d'octets indiqué.

public:
 override int GetBytes(System::String ^ s, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : string * int * int * byte[] * int -> int
Public Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Paramètres

s
String

Chaîne contenant le jeu de caractères à encoder.

charIndex
Int32

Index du premier caractère à encoder.

charCount
Int32

Nombre de caractères à encoder.

bytes
Byte[]

Tableau d'octets destiné à contenir la séquence d'octets obtenue.

byteIndex
Int32

Index auquel commencer l'écriture de la séquence d'octets obtenue.

Retours

Int32

Nombre réel d'octets écrits dans bytes.

Exceptions

ArgumentNullException

s a la valeur null.

  • ou - bytes a la valeur null (Nothing).
ArgumentOutOfRangeException

charIndex, charCount ou byteIndex est inférieur à zéro.

  • ou - charIndex et charCount ne désignent pas une plage valide dans chars.

  • ou - byteIndex n'est pas un index valide dans bytes.

ArgumentException

La détection d’erreurs est activée et s contient une séquence de caractères non valide.

  • ou - bytes ne possède pas une capacité suffisante entre byteIndex et la fin du tableau pour prendre en charge les octets obtenus.
EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Codage de caractères dans .NET) -et- EncoderFallback a la valeur EncoderExceptionFallback.

Exemples

L’exemple suivant montre comment encoder une plage d’éléments à partir d’un tableau de caractères Unicode et stocker les octets encodés dans une plage d’éléments d’un tableau d’octets.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = Unicode->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = Unicode->GetBytes( chars, 1, 2, bytes, 0 );
   Console::WriteLine( "{0} bytes used to encode characters.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 1, 2, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte

        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 1, 2, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Remarques

Pour calculer la taille exacte du tableau requise pour GetBytes stocker les octets résultants, vous appelez la GetByteCount méthode. Pour calculer la taille maximale du tableau, vous appelez la GetMaxByteCount méthode. La GetByteCount méthode alloue généralement moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Avec la détection d’erreur, une séquence non valide entraîne la levée d’une ArgumentExceptionméthode . Sans détection d’erreur, les séquences non valides sont ignorées et aucune exception n’est levée.

Les données à convertir, telles que les données lues à partir d’un flux, peuvent être disponibles uniquement dans des blocs séquentiels. Dans ce cas, ou si la quantité de données est si importante qu’elle doit être divisée en blocs plus petits, l’application doit utiliser respectivement la Decoder GetDecoder méthode ou GetEncoder la Encoder méthode fournie.

Important

Pour vous assurer que les octets encodés sont correctement décodés lorsqu’ils sont enregistrés en tant que fichier ou en tant que flux, vous pouvez préfixer un flux d’octets encodés avec un préambule. L’insertion du préambule au début d’un flux d’octets (par exemple, au début d’une série d’octets à écrire dans un fichier) est la responsabilité du développeur. La GetBytes méthode n’ajoute pas de préambule au début d’une séquence d’octets encodés.

Voir aussi

S’applique à

GetBytes(String)

Encode un jeu de caractères de la chaîne spécifiée dans le tableau d’octets indiqué.

public:
 override cli::array <System::Byte> ^ GetBytes(System::String ^ s);
public override byte[] GetBytes (string s);
override this.GetBytes : string -> byte[]
Public Overrides Function GetBytes (s As String) As Byte()

Paramètres

s
String

Retours

Byte[]

S’applique à

GetBytes(Char*, Int32, Byte*, Int32)

Important

Cette API n’est pas conforme CLS.

Code une séquence de caractères commençant au pointeur de caractère spécifié en une séquence d'octets, qui sera stockée à partir du pointeur d'octet spécifié.

public:
 override int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount);
[System.CLSCompliant(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

Paramètres

chars
Char*

Pointeur du premier caractère à encoder.

charCount
Int32

Nombre de caractères à encoder.

bytes
Byte*

Pointeur de l'emplacement où commencer l'écriture de la séquence d'octets obtenue.

byteCount
Int32

Nombre maximal d'octets à écrire.

Retours

Int32

Nombre réel d'octets écrits à l'emplacement indiqué par le paramètre bytes.

Attributs
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceptions

ArgumentNullException

chars a la valeur null (Nothing).

  • ou - bytes a la valeur null (Nothing).
ArgumentOutOfRangeException

charCount ou byteCount est inférieur à zéro.

ArgumentException

La détection d’erreurs est activée et chars contient une séquence de caractères non valide.

  • ou - byteCount est inférieur au nombre d'octets obtenus.
EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Codage de caractères dans .NET) -et- EncoderFallback a la valeur EncoderExceptionFallback.

Remarques

Pour calculer la taille exacte du tableau qui GetBytes nécessite de stocker les octets résultants, vous appelez la GetByteCount méthode. Pour calculer la taille maximale du tableau, vous appelez la GetMaxByteCount méthode. La GetByteCount méthode alloue généralement moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Avec la détection d’erreurs, une séquence non valide entraîne la levée d’une ArgumentExceptionméthode . Sans détection d’erreur, les séquences non valides sont ignorées et aucune exception n’est levée.

Les données à convertir, telles que les données lues à partir d’un flux, peuvent être disponibles uniquement dans les blocs séquentiels. Dans ce cas, ou si la quantité de données est si volumineuse qu’elle doit être divisée en blocs plus petits, l’application doit utiliser l’objet Decoder ou Encoder l’objet fourni par la GetDecoder GetEncoder méthode, respectivement.

Important

Pour vous assurer que les octets codés sont décodés correctement lorsqu’ils sont enregistrés en tant que fichier ou en tant que flux, vous pouvez préfixer un flux d’octets encodés avec un préambule. L’insertion du préambule au début d’un flux d’octets (par exemple, au début d’une série d’octets à écrire dans un fichier) est la responsabilité du développeur. La GetBytes méthode ne prépendait pas un préambule au début d’une séquence d’octets encodés.

Voir aussi

S’applique à