ASCIIEncoding.GetString Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Aşırı Yüklemeler

GetString(Byte[], Int32, Int32)

Bayt dizisinden bir dizeye bayt aralığının kodunu çözer.

GetString(Byte[], Int32, Int32)

Kaynak:

ASCIIEncoding.cs

Bayt dizisinden bir dizeye bayt aralığının kodunu çözer.

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

Parametreler

bytes

Byte[]

Kod çözme bayt sırasını içeren bayt dizisi.

byteIndex

Int32

Kodunu çözmek için ilk bayt dizini.

byteCount

Int32

Kodu çözecek bayt sayısı.

Döndürülenler

String

String Belirtilen bayt dizisinin kodunu çözmenin sonuçlarını içeren bir.

Özel durumlar

ArgumentNullException

bytes, null değeridir.

ArgumentOutOfRangeException

index veya count sıfırdan küçüktür.

-veya-

index ve count içinde bytesgeçerli bir aralığı ifade etmeyin.

DecoderFallbackException

Bir geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

DecoderFallback olarak ayarlanır DecoderExceptionFallback.

Örnekler

Aşağıdaki örnekte, bir bayt dizisini GetString içine dönüştürmek için yönteminin nasıl kullanılacağı gösterilmektedir 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'

Açıklamalar

Bir akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, uygulama sırasıyla yöntemi veya yöntemi tarafından GetDecoder sağlanan öğesini kullanmalıdır.DecoderEncoderGetEncoder

ASCIIEncoding hata algılama sağlamaz. Onaltılık 0x7F büyük olan baytların kodu Unicode soru işareti ("?") olarak çözülmektedir.

Dikkat

Güvenlik nedeniyle , veya sınıflarını UTF8Encodingkullanmanız ve sınıfını kullanmak yerine hata algılamayı ASCIIEncoding etkinleştirmeniz UTF32Encoding gerekir. UnicodeEncoding

Ayrıca bkz.

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