ASCIIEncoding.GetString Méthode

Définition

Espace de noms:

System.Text

Assembly:

mscorlib.dll

Surcharges

Nom	Description
GetString(Byte[], Int32, Int32)	Décode une plage d’octets d’un tableau d’octets dans une chaîne.

GetString(Byte[], Int32, Int32)

Décode une plage d’octets d’un tableau d’octets dans une chaîne.

public:
 override System::String ^ GetString(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount);

public override string GetString(byte[] bytes, int byteIndex, int byteCount);

override this.GetString : byte[] * int * int -> string

Public Overrides Function GetString (bytes As Byte(), byteIndex As Integer, byteCount As Integer) As String

Paramètres

bytes

Byte[]

Tableau d’octets contenant la séquence d’octets à décoder.

byteIndex

Int32

Index du premier octet à décoder.

byteCount

Int32

Nombre d’octets à décoder.

Retours

String

Contenant String les résultats du décodage de la séquence spécifiée d’octets.

Exceptions

ArgumentNullException

bytes a la valeur null.

ArgumentOutOfRangeException

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

-ou-

byteIndex et byteCount ne désignent pas une plage valide en bytes.

DecoderFallbackException

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

-et-

DecoderFallback a la valeur DecoderExceptionFallback.

Exemples

L’exemple suivant montre comment utiliser la GetString méthode pour convertir un tableau d’octets en un String.

using System;
using System.Text;

class Example 
{
    public static void Main() 
    {
        // Define a string.
        String original = "ASCII Encoding Example";
        // Instantiate an ASCII encoding object.
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        // Create an ASCII byte array.
        Byte[] bytes = ascii.GetBytes(original); 
        
        // Display encoded bytes.
        Console.Write("Encoded bytes (in hex):  ");
        foreach (var value in bytes)
           Console.Write("{0:X2} ", value);
        Console.WriteLine();

        // Decode the bytes and display the resulting Unicode string.
        String decoded = ascii.GetString(bytes);
        Console.WriteLine("Decoded string: '{0}'", decoded);
    }
}
// The example displays the following output:
//     Encoded bytes (in hex):  41 53 43 49 49 20 45 6E 63 6F 64 69 6E 67 20 45 78 61 6D 70 6C 65
//     Decoded string: 'ASCII Encoding Example'

Imports System.Text

Module Example
   
    Public Sub Main()
        ' Define a string.
        Dim original As String = "ASCII Encoding Example"
        ' Instantiate an ASCII encoding object.
        Dim ascii As New ASCIIEncoding()
        
        ' Create an ASCII byte array.
        Dim bytes() As Byte = ascii.GetBytes(original) 
        
        ' Display encoded bytes.
        Console.Write("Encoded bytes (in hex):  ")
        For Each value In bytes
           Console.Write("{0:X2} ", value)
        Next   
        Console.WriteLine()

        ' Decode the bytes and display the resulting Unicode string.
        Dim decoded As String = ascii.GetString(bytes)
        Console.WriteLine("Decoded string: '{0}'", decoded)
    End Sub
End Module
' The example displays the following output:
'   Encoded bytes (in hex):  41 53 43 49 49 20 45 6E 63 6F 64 69 6E 67 20 45 78 61 6D 70 6C 65
'   Decoded string: 'ASCII Encoding Example'

Remarques

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 si importante qu’elle doit être divisée en blocs plus petits, l’application doit utiliser respectivement la Decoder méthode ou Encoder la GetDecoderGetEncoder méthode fournie.

ASCIIEncoding ne fournit pas de détection d’erreur. Tout octet supérieur à l'0x7F hexadécimal est décodé en tant que point d’interrogation Unicode (« ? »).

Avertissement

Pour des raisons de sécurité, vous devez utiliser les classes ou UnicodeEncodingUTF32Encoding les UTF8Encodingclasses et activer la détection d’erreurs au lieu d’utiliser la ASCIIEncoding classe.

Voir aussi

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetDecoder()
• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)