ASCIIEncoding.GetString Metoda

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Text.Encoding.Extensions.dll

Přetížení

GetString(Byte[], Int32, Int32)

Dekóduje rozsah bajtů z pole bajtů do řetězce.

GetString(Byte[], Int32, Int32)

Zdroj:

ASCIIEncoding.cs

Dekóduje rozsah bajtů z pole bajtů do řetězce.

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

Parametry

bytes

Byte[]

Pole bajtů obsahující posloupnost bajtů k dekódování.

byteIndex

Int32

Index prvního bajtu k dekódování.

byteCount

Int32

Počet bajtů k dekódování.

Návraty

String

Obsahující String výsledky dekódování zadané posloupnosti bajtů.

Výjimky

ArgumentNullException

bytes je null.

ArgumentOutOfRangeException

index nebo count je menší než nula.

-nebo-

index a count neoznamují platnou oblast v bytessouboru .

DecoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET)

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje použití GetString metody k převodu pole bajtů na 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'

Poznámky

Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, měla by aplikace použít metodu Decoder nebo Encoder metodu, která je poskytována GetDecoder metodou GetEncoder v uvedeném pořadí.

ASCIIEncoding neposkytuje detekci chyb. Jakýkoli bajt větší než hexadecimální 0x7F je dekódován jako otazník Unicode ("?").

Upozornění

Z bezpečnostních důvodů byste měli místo třídy použít UTF8Encodingtřídy , UnicodeEncodingnebo UTF32Encoding a povolit detekci ASCIIEncoding chyb.

Viz také

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