UnicodeEncoding.GetChars Metode

Definisi

Ruang nama:

System.Text

Rakitan:

System.Text.Encoding.Extensions.dll

Mendekode urutan byte menjadi sekumpulan karakter.

Overload

GetChars(Byte*, Int32, Char*, Int32)	Mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan mulai dari penunjuk karakter yang ditentukan.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Mendekode urutan byte dari array byte yang ditentukan ke dalam array karakter yang ditentukan.

GetChars(Byte*, Int32, Char*, Int32)

Sumber:

UnicodeEncoding.cs

Penting

API ini bukan kompatibel CLS.

Mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan mulai dari penunjuk karakter yang ditentukan.

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);

[<System.CLSCompliant(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Parameter

bytes

Byte*

Penunjuk ke byte pertama yang akan didekodekan.

byteCount

Int32

Jumlah byte yang akan didekodekan.

chars

Char*

Penunjuk ke lokasi untuk mulai menulis kumpulan karakter yang dihasilkan.

charCount

Int32

Jumlah maksimum karakter yang akan ditulis.

Mengembalikan

Int32

Jumlah karakter aktual yang ditulis di lokasi yang ditunjukkan oleh chars parameter .

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

bytes adalah null (Nothing).

-atau-

chars adalah null (Nothing).

ArgumentOutOfRangeException

byteCount atau charCount kurang dari nol.

ArgumentException

Deteksi kesalahan diaktifkan, dan bytes berisi urutan byte yang tidak valid.

-atau-

charCount kurang dari jumlah karakter yang dihasilkan.

DecoderFallbackException

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

-dan-

DecoderFallback diatur ke DecoderExceptionFallback.

Keterangan

Untuk menghitung ukuran array yang tepat yang GetChars mengharuskan untuk menyimpan karakter yang dihasilkan, aplikasi menggunakan GetCharCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxCharCount. Metode ini GetCharCount umumnya mengalokasikan lebih sedikit memori, sementara GetMaxCharCount metode umumnya dijalankan lebih cepat.

Dengan deteksi kesalahan, urutan yang tidak valid menyebabkan metode ini melempar .ArgumentException Tanpa deteksi kesalahan, urutan yang tidak valid diabaikan, dan tidak ada pengecualian yang dilemparkan.

Jika rentang byte yang akan didekodekan menyertakan tanda urutan byte (BOM) dan array byte dikembalikan oleh metode jenis sadar non-BOM, karakter U+FFFE disertakan dalam array karakter yang dikembalikan oleh metode ini. Anda dapat menghapusnya dengan memanggil String.TrimStart metode .

Data yang akan dikonversi, seperti data yang dibaca dari aliran, mungkin hanya 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 objek yang disediakan oleh GetDecoder atau GetEncoder metode , masing-masing.

Lihat juga

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)

GetChars(Byte[], Int32, Int32, Char[], Int32)

Sumber:

UnicodeEncoding.cs

Mendekode urutan byte dari array byte yang ditentukan ke dalam array karakter yang ditentukan.

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public override int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

override this.GetChars : byte[] * int * int * char[] * int -> int

Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parameter

bytes

Byte[]

Array byte yang berisi urutan byte yang akan didekodekan.

byteIndex

Int32

Indeks byte pertama yang didekodekan.

byteCount

Int32

Jumlah byte yang akan didekodekan.

chars

Char[]

Array karakter yang berisi kumpulan karakter yang dihasilkan.

charIndex

Int32

Indeks untuk mulai menulis kumpulan karakter yang dihasilkan.

Mengembalikan

Int32

Jumlah karakter aktual yang ditulis ke dalam chars.

Pengecualian

ArgumentNullException

bytes adalah null (Nothing).

-atau-

chars adalah null (Nothing).

ArgumentOutOfRangeException

byteIndex atau byteCount atau charIndex kurang dari nol.

-atau-

byteindex dan byteCount jangan menandakan rentang yang valid di bytes.

-atau-

charIndex bukan indeks yang valid di chars.

ArgumentException

Deteksi kesalahan diaktifkan, dan bytes berisi urutan byte yang tidak valid.

-atau-

chars tidak memiliki kapasitas yang cukup dari charIndex hingga akhir array untuk mengakomodasi karakter yang dihasilkan.

DecoderFallbackException

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

-dan-

DecoderFallback diatur ke DecoderExceptionFallback.

Contoh

Contoh berikut menunjukkan cara menggunakan GetChars metode untuk mendekode rentang elemen dalam array byte dan menyimpan hasilnya dalam array karakter.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = Unicode->GetCharCount( bytes, 2, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = Unicode->GetChars( bytes, 2, 8, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        UnicodeEncoding Unicode = new UnicodeEncoding();

        int charCount = Unicode.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = Unicode.GetChars(bytes, 2, 8, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
        
        Dim uni As New UnicodeEncoding()
        
        Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = uni.GetChars(bytes, 2, 8, chars, 0)
        
        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

Keterangan

Untuk menghitung ukuran array yang tepat yang diperlukan oleh GetChars untuk menyimpan karakter yang dihasilkan, aplikasi menggunakan GetCharCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxCharCount. Metode ini GetCharCount umumnya mengalokasikan lebih sedikit memori, sementara GetMaxCharCount metode umumnya dijalankan lebih cepat.

Dengan deteksi kesalahan, urutan yang tidak valid menyebabkan metode ini melempar .ArgumentException Tanpa deteksi kesalahan, urutan yang tidak valid diabaikan, dan tidak ada pengecualian yang dilemparkan.

Jika rentang byte yang akan didekodekan menyertakan tanda urutan byte (BOM) dan array byte dikembalikan oleh metode jenis sadar non-BOM, karakter U+FFFE disertakan dalam array karakter yang dikembalikan oleh metode ini. Anda dapat menghapusnya dengan memanggil String.TrimStart metode .

Data yang akan dikonversi, seperti data yang dibaca dari aliran, mungkin hanya 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 .

Lihat juga

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)