UTF8Encoding.GetBytes Méthode

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.

Encode un jeu de caractères dans une séquence d’octets.

Surcharges

Nom	Description
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Encode un jeu de caractères du tableau de caractères spécifié dans le tableau d’octets spécifié.
GetBytes(String, Int32, Int32, Byte[], Int32)	Encode un jeu de caractères du tableau d’octets String spécifié.
GetBytes(String)	Encode les caractères d’un objet spécifié String dans une séquence d’octets.
GetBytes(Char, Int32, Byte, Int32)	Encode un jeu de caractères commençant par le pointeur de caractères spécifié dans une séquence d’octets stockés à 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 spécifié.

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 à contenir la séquence d’octets résultante.

byteIndex: Int32

Index auquel commencer l’écriture de la séquence d’octets résultante.

Retours

Int32

Nombre réel d’octets écrits en bytes.

Exceptions

ArgumentNullException

chars a la valeur null.

-ou-

bytes a la valeur null.

ArgumentOutOfRangeException

charIndex ou charCountbyteIndex est inférieur à zéro.

-ou-

charIndex et charCount ne désignent pas une plage valide en chars.

-ou-

byteIndex n’est pas un index valide dans bytes.

ArgumentException

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

-ou-

bytes n’a pas suffisamment de capacité de byteIndex la fin du tableau pour prendre en charge les octets résultants.

EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET)

-et-

EncoderFallback a la valeur EncoderExceptionFallback.

Exemples

L’exemple suivant utilise la GetBytes méthode pour encoder une plage de caractères à partir d’une chaîne et stocke les octets encodés dans une plage d’éléments d’un tableau d’octets.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "UTF8 Encoding Example";
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars.ToCharArray(), 0, 13);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.GetBytes(chars, 0, 13, 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 UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "UTF8 Encoding Example"
        
        Dim utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars.ToCharArray(), 0, 13)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 0, 13, 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’erreurs, une séquence non valide provoque la levée d’une ArgumentException exception par cette mé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, utilisez respectivement la Decoder GetDecoder méthode ou Encoder la GetEncoder méthode fournie.

Pour vous assurer que les octets encodé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 à

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

Encode un jeu de caractères du tableau d’octets String spécifié.

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

Contenant String 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 à contenir la séquence d’octets résultante.

byteIndex: Int32

Index auquel commencer l’écriture de la séquence d’octets résultante.

Retours

Int32

Nombre réel d’octets écrits en bytes.

Exceptions

ArgumentNullException

s a la valeur null.

-ou-

bytes a la valeur null.

ArgumentOutOfRangeException

charIndex ou charCountbyteIndex est inférieur à zéro.

-ou-

charIndex et charCount ne désignent pas une plage valide en s.

-ou-

byteIndex n’est pas un index valide dans bytes.

ArgumentException

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

-ou-

bytes n’a pas suffisamment de capacité de byteIndex la fin du tableau pour prendre en charge les octets résultants.

EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET)

-et-

EncoderFallback a la valeur EncoderExceptionFallback.

Exemples

L’exemple suivant utilise la GetBytes méthode pour 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 dans un tableau d’octets.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.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 UTF8EncodingExample
    
    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 utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.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

Voir aussi

S’applique à

GetBytes(String)

Encode les caractères d’un objet spécifié String dans une séquence d’octets.

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

Chaîne de caractères à encoder.

Retours

Byte[]

Tableau d’octets qui contient les caractères encodés dans la chaîne spécifiée par le paramètre s.

S’applique à

GetBytes(Char, Int32, Byte, Int32)

Important

Cette API n’est pas conforme CLS.

Encode un jeu de caractères commençant par le pointeur de caractères spécifié dans une séquence d’octets stockés à partir du pointeur d’octet spécifié.

public:
 override int GetBytes(char* chars, int charCount, System::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)]
public override int GetBytes(char* chars, int charCount, byte* bytes, int byteCount);

[<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

[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

Paramètres

chars: Char*

Pointeur vers le premier caractère à encoder.

charCount: Int32

Nombre de caractères à encoder.

bytes: Byte*

Pointeur vers l’emplacement auquel commencer l’écriture de la séquence résultante d’octets.

byteCount: Int32

Nombre maximal d’octets à écrire.

Retours

Int32

Nombre réel d’octets écrits à l’emplacement indiqué par bytes.

Attributs: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceptions

ArgumentNullException

chars a la valeur null.

-ou-

bytes a la valeur null.

ArgumentOutOfRangeException

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

ArgumentException

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

-ou-

byteCount est inférieur au nombre obtenu d’octets.

EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET)

-et-

EncoderFallback a la valeur EncoderExceptionFallback.

Remarques

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, utilisez respectivement la Decoder méthode ou la Encoder GetEncoder méthode retournéeGetDecoder.

Voir aussi

S’applique à

Commentaires

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

UTF8Encoding.GetBytes Méthode

Définition

Surcharges

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

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

GetBytes(String)

Paramètres

Retours

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Commentaires

GetBytes(Char, Int32, Byte, Int32)