ASCIIEncoding.GetString Metode

Definisi

Ruang nama:

System.Text

Rakitan:

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

Overload

Nama	Deskripsi
GetString(Byte[], Int32, Int32)	Mendekode rentang byte dari array byte ke dalam string.

GetString(Byte[], Int32, Int32)

Sumber:

ASCIIEncoding.cs

Mendekode rentang byte dari array byte ke dalam 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

Parameter

bytes

Byte[]

Array byte yang berisi urutan byte untuk didekodekan.

byteIndex

Int32

Indeks byte pertama yang didekodekan.

byteCount

Int32

Jumlah byte yang akan didekodekan.

Mengembalikan

String

yang String berisi hasil decoding urutan byte yang ditentukan.

Pengecualian

ArgumentNullException

bytes adalah null.

ArgumentOutOfRangeException

byteIndex atau byteCount kurang dari nol.

-atau-

byteIndex dan byteCount jangan menandakan rentang yang valid di bytes.

DecoderFallbackException

Fallback terjadi (untuk informasi selengkapnya, lihat Pengodean Karakter di .NET)

-dan-

DecoderFallback diatur ke DecoderExceptionFallback.

Contoh

Contoh berikut menunjukkan cara menggunakan GetString metode untuk mengonversi array byte menjadi 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'

Keterangan

Data yang akan dikonversi, seperti data yang dibaca dari aliran, hanya dapat tersedia dalam blok berurutan. Dalam hal ini, atau jika jumlah data sangat besar sehingga perlu dibagi menjadi blok yang lebih kecil, aplikasi harus menggunakan Decoder atau Encoder yang disediakan oleh GetDecoder metode atau GetEncoder metode, masing-masing.

ASCIIEncoding tidak menyediakan deteksi kesalahan. Byte apa pun yang lebih besar dari 0x7F heksadesimal didekodekan sebagai tanda tanya Unicode ("?").

Caution

Untuk alasan keamanan, Anda harus menggunakan UTF8Encodingkelas , , UnicodeEncodingatau UTF32Encoding dan mengaktifkan deteksi kesalahan alih-alih menggunakan ASCIIEncoding kelas .

Lihat juga

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