ASCIIEncoding.GetString ASCIIEncoding.GetString ASCIIEncoding.GetString ASCIIEncoding.GetString Method

Definizione

Overload

GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32)

Decodifica un intervallo di byte da una matrice di byte in una stringa.Decodes a range of bytes from a byte array into a string.

GetString(Byte[]) GetString(Byte[]) GetString(Byte[]) GetString(Byte[])

GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32)

Decodifica un intervallo di byte da una matrice di byte in una stringa.Decodes a range of bytes from a byte array into a string.

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

Parametri

bytes
Byte[]

Matrice di byte contenente la sequenza di byte da decodificare.The byte array containing the sequence of bytes to decode.

byteIndex
Int32 Int32 Int32 Int32

Indice del primo byte da decodificare.The index of the first byte to decode.

byteCount
Int32 Int32 Int32 Int32

Numero di byte da decodificare.The number of bytes to decode.

Restituisce

Oggetto String contenente i risultati di decodifica della sequenza di byte specificata.A String containing the results of decoding the specified sequence of bytes.

Eccezioni

index o count è minore di zero.index or count is less than zero.

In alternativa-or- index e count non indicano un intervallo valido in bytes.index and count do not denote a valid range in bytes.

Esempi

L'esempio seguente illustra come usare il GetString metodo per convertire una matrice di byte in un String.The following example demonstrates how to use the GetString method to convert a byte array into a String.

using namespace System;
using namespace System::Text;

int main()
{
    // Define a string.
    String^ original = "ASCII Encoding Example";
    // Instantiate an ASCII encoding object.
    ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
    
    // Create an ASCII byte array.
    array<Byte>^ bytes = ascii->GetBytes(original); 
    
    // Display encoded bytes.
    Console::Write("Encoded bytes (in hex):  ");
    for each (Byte 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'
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'

Commenti

Dati da convertire, ad esempio i dati letti da un flusso, possono essere disponibili solo in blocchi sequenziali.Data to be converted, such as data read from a stream, can be available only in sequential blocks. In questo caso, o se la quantità di dati è talmente grande che deve essere suddiviso in blocchi più piccoli, l'applicazione deve utilizzare il Decoder o il Encoder forniti dalle GetDecoder (metodo) o il GetEncoder metodo, rispettivamente.In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the Decoder or the Encoder provided by the GetDecoder method or the GetEncoder method, respectively.

ASCIIEncoding non fornisce il rilevamento errori.ASCIIEncoding does not provide error detection. Qualsiasi byte maggiori di 0x7F esadecimali viene decodificato come Unicode punto interrogativo ("?").Any byte greater than hexadecimal 0x7F is decoded as the Unicode question mark ("?").

Attenzione

Per motivi di sicurezza, è consigliabile usare la UTF8Encoding, UnicodeEncoding, o UTF32Encoding classi e abilitare il rilevamento di errori invece di usare il ASCIIEncoding classe.For security reasons, you should use the UTF8Encoding, UnicodeEncoding, or UTF32Encoding classes and enable error detection instead of using the ASCIIEncoding class.

Vedi anche

GetString(Byte[]) GetString(Byte[]) GetString(Byte[]) GetString(Byte[])

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

Parametri

bytes
Byte[]

Restituisce

Si applica a