UTF7Encoding.GetChars Metode

Definisi

Ruang nama:

System.Text

Rakitan:

System.Text.Encoding.Extensions.dll

Mendekode urutan byte menjadi satu set karakter.

Overload

GetChars(Byte*, Int32, Char*, Int32)	Mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan dimulai pada 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:

UTF7Encoding.cs

Penting

API ini bukan kompatibel CLS.

Mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan dimulai pada 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 didekodekan.

byteCount

Int32

Jumlah byte yang akan didekodekan.

chars

Char*

Penunjuk ke lokasi untuk mulai menulis sekumpulan karakter yang dihasilkan.

charCount

Int32

Jumlah maksimum karakter yang akan ditulis.

Mengembalikan

Int32

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

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

bytes adalah null (Nothing).

-atau-

chars adalah null (Nothing).

ArgumentOutOfRangeException

byteCount atau charCount kurang dari nol.

ArgumentException

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 diperlukan oleh GetChars untuk menyimpan karakter yang dihasilkan, gunakan GetCharCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxCharCount. Metode ini GetCharCount umumnya memungkinkan alokasi memori yang lebih sedikit, sementara metode umumnya GetMaxCharCount dijalankan lebih cepat.

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 .

Catatan

UTF7Encoding tidak menyediakan deteksi kesalahan. Ketika byte tidak valid ditemukan, UTF7Encoding umumnya memancarkan byte yang tidak valid. Jika byte lebih besar dari 0x7F heksadesimal, nilai byte tidak diperluas ke dalam karakter Unicode, hasilnya disimpan dalam chars array, dan urutan shift apa pun dihentikan. Misalnya, jika byte yang akan dikodekan adalah 0x81 heksadesimal, karakter yang dihasilkan adalah U+0081. Untuk alasan keamanan, aplikasi Anda disarankan untuk menggunakan UTF8Encoding, , UnicodeEncodingatau UTF32Encoding dan mengaktifkan deteksi kesalahan.

Lihat juga

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

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

Sumber:

UTF7Encoding.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 untuk berisi sekumpulan karakter yang dihasilkan.

charIndex

Int32

Indeks untuk mulai menulis sekumpulan 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 tidak menunjukkan rentang yang valid dalam bytes.

-atau-

charIndex bukan indeks yang valid di chars.

ArgumentException

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 kode 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,84,70,55,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int charCount = utf7->GetCharCount( bytes, 2, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = utf7->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 UTF7EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  55,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF7Encoding utf7 = new UTF7Encoding();

        int charCount = utf7.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = utf7.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 UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  55,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf7 As New UTF7Encoding()
        
        Dim charCount As Integer = utf7.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf7.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, gunakan GetCharCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxCharCount. Metode ini GetCharCount umumnya memungkinkan alokasi memori yang lebih sedikit, sementara metode umumnya GetMaxCharCount dijalankan lebih cepat.

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 .

Catatan

UTF7Encoding tidak menyediakan deteksi kesalahan. Ketika byte tidak valid ditemukan, UTF7Encoding umumnya memancarkan byte yang tidak valid. Jika byte lebih besar dari 0x7F heksadesimal, nilai byte tidak diperluas ke dalam karakter Unicode, hasilnya disimpan dalam chars array, dan urutan shift apa pun dihentikan. Misalnya, jika byte yang akan dikodekan adalah 0x81 heksadesimal, karakter yang dihasilkan adalah U+0081. Untuk alasan keamanan, aplikasi Anda disarankan untuk menggunakan UTF8Encoding, , UnicodeEncodingatau UTF32Encoding dan mengaktifkan deteksi kesalahan.

Lihat juga

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