Partager via


ASCIIEncoding.GetBytes Méthode

Définition

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

Surcharges

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Encode l’étendue de caractères spécifiée dans l’étendue d’octets spécifiée.

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é.

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(ReadOnlySpan<Char>, Span<Byte>)

Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs

Encode l’étendue de caractères spécifiée dans l’étendue d’octets spécifiée.

public:
 override int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes);
public override int GetBytes (ReadOnlySpan<char> chars, Span<byte> bytes);
override this.GetBytes : ReadOnlySpan<char> * Span<byte> -> int
Public Overrides Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte)) As Integer

Paramètres

chars
ReadOnlySpan<Char>

Étendue de caractères à encoder.

bytes
Span<Byte>

Étendue pour contenir le jeu d’octets obtenu.

Retours

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

Remarques

Pour calculer la taille exacte requise par GetBytes pour stocker les octets résultants, utilisez GetByteCount. Pour calculer la taille maximale, utilisez GetMaxByteCount. La GetByteCount méthode permet généralement d’allouer moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Les données à convertir, telles que les données lues à partir d’un flux, ne peuvent être disponibles que dans des blocs séquentiels. Dans ce cas, ou si la quantité de données est tellement importante qu’elle doit être divisée en blocs plus petits, utilisez respectivement le DecoderEncoder ou fourni par la GetDecoder méthode ou la GetEncoder méthode.

ASCIIEncoding ne fournit pas de détection d’erreur. Tout caractère Unicode supérieur U+007F à est encodé en tant que point d’interrogation ASCII (« ? »).

Attention

Pour des raisons de sécurité, vous devez utiliser UTF8Encoding, UnicodeEncodingou UTF32Encoding et activer la détection d’erreurs.

S’applique à

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

Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Text.ASCIIEncoding.GetBytes(Char[], Int32, 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é.

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)]
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)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
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

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

Attributs

Exceptions

chars a la valeur null.

-ou-

bytes a la valeur null.

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

byteCount est inférieur au nombre d'octets obtenus.

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 nécessaire GetBytes pour stocker les octets résultants, l’application utilise GetByteCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxByteCount. La GetByteCount méthode permet généralement d’allouer moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

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

ASCIIEncoding ne fournit pas de détection d’erreur. Tout caractère Unicode supérieur à U+007F est traduit en point d’interrogation ASCII (« ? »).

Attention

Pour des raisons de sécurité, il est recommandé d’utiliser UTF8Encoding, UnicodeEncodingou et UTF32Encoding d’activer la détection des erreurs.

Voir aussi

S’applique à

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

Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs

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

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

Exceptions

chars a la valeur null.

-ou-

bytes a la valeur null.

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.

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

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’une chaîne et stocker les caractères codés dans une plage d’éléments dans un tableau d’octets.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   String^ chars = "ASCII Encoding Example";
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars->ToCharArray(), 6, 8 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = ascii->GetBytes( chars, 6, 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 ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "ASCII Encoding Example";
        
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        int byteCount = ascii.GetByteCount(chars.ToCharArray(), 6, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = ascii.GetBytes(chars, 6, 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 ASCIIEncodingExample
   
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()

        Dim byteCount As Integer = ascii.GetByteCount(chars.ToCharArray(), 6, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = ascii.GetBytes(chars, 6, 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 nécessaire GetBytes pour stocker les octets résultants, l’application utilise GetByteCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxByteCount. La GetByteCount méthode permet généralement d’allouer moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

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

ASCIIEncoding ne fournit pas de détection d’erreur. Tout caractère Unicode supérieur à U+007F est encodé en tant que point d’interrogation ASCII (« ? »).

Attention

Pour des raisons de sécurité, il est recommandé d’utiliser UTF8Encoding, UnicodeEncodingou et UTF32Encoding d’activer la détection des erreurs.

Voir aussi

S’applique à

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

Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs
Source:
ASCIIEncoding.cs

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

Paramètres

chars
String

String 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

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

Exceptions

s a la valeur null.

-ou-

bytes a la valeur null.

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.

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

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

        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1){}
        Dim bytesEncodedCount As Integer = ascii.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 nécessaire GetBytes pour stocker les octets résultants, l’application utilise GetByteCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxByteCount. La GetByteCount méthode permet généralement d’allouer moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

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

ASCIIEncoding ne fournit pas de détection des erreurs. Tout caractère Unicode supérieur à U+007F est encodé en tant que point d’interrogation ASCII (« ? »).

Attention

Pour des raisons de sécurité, il est recommandé d’utiliser UTF8Encoding, UnicodeEncodingou et UTF32Encoding d’activer la détection des erreurs.

Voir aussi

S’applique à