Bagikan melalui


ASCIIEncoding.GetCharCount Metode

Definisi

Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte.

Overload

GetCharCount(Byte*, Int32)

Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan.

GetCharCount(Byte[], Int32, Int32)

Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte dari array byte yang ditentukan.

GetCharCount(ReadOnlySpan<Byte>)

Menghitung jumlah karakter yang dihasilkan dengan mendekode rentang byte yang ditentukan.

GetCharCount(Byte*, Int32)

Sumber:
ASCIIEncoding.cs
Sumber:
ASCIIEncoding.cs
Sumber:
ASCIIEncoding.cs

Penting

API ini bukan kompatibel CLS.

Alternatif kompatibel CLS
System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan.

public:
 override int GetCharCount(System::Byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int

Parameter

bytes
Byte*

Penunjuk ke byte pertama yang akan didekodekan.

count
Int32

Jumlah byte yang akan didekodekan.

Mengembalikan

Jumlah karakter yang dihasilkan dengan mendekode urutan byte yang ditentukan.

Atribut

Pengecualian

bytesadalah null.

count kurang dari nol.

-atau-

Jumlah byte yang dihasilkan lebih besar dari angka maksimum yang dapat dikembalikan sebagai bilangan bulat.

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, aplikasi menggunakan GetCharCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxCharCount. Metode ini GetCharCount umumnya memungkinkan alokasi lebih sedikit memori, sementara GetMaxCharCount metode umumnya dijalankan lebih cepat.

Lihat juga

Berlaku untuk

GetCharCount(Byte[], Int32, Int32)

Sumber:
ASCIIEncoding.cs
Sumber:
ASCIIEncoding.cs
Sumber:
ASCIIEncoding.cs

Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte dari array byte yang ditentukan.

public:
 override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);
public override int GetCharCount (byte[] bytes, int index, int count);
override this.GetCharCount : byte[] * int * int -> int
Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Parameter

bytes
Byte[]

Array byte yang berisi urutan byte yang akan didekodekan.

index
Int32

Indeks byte pertama yang didekodekan.

count
Int32

Jumlah byte yang akan didekodekan.

Mengembalikan

Jumlah karakter yang dihasilkan dengan mendekode urutan byte yang ditentukan.

Pengecualian

bytesadalah null.

index atau count kurang dari nol.

-atau-

index dan count jangan menandakan rentang yang valid di bytes.

-atau-

Jumlah byte yang dihasilkan lebih besar dari angka maksimum yang dapat dikembalikan sebagai bilangan bulat.

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

-dan-

DecoderFallback diatur ke DecoderExceptionFallback.

Contoh

Contoh berikut menunjukkan cara menggunakan GetCharCount metode untuk mengembalikan jumlah karakter yang dihasilkan dengan mendekode rentang elemen dalam array byte.

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = ascii->GetCharCount( bytes, 6, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}
using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int charCount = ascii.GetCharCount(bytes, 6, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}
Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}
      
        Dim ascii As New ASCIIEncoding()
        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    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 memungkinkan alokasi lebih sedikit memori, sementara GetMaxCharCount metode umumnya dijalankan lebih cepat.

Lihat juga

Berlaku untuk

GetCharCount(ReadOnlySpan<Byte>)

Sumber:
ASCIIEncoding.cs
Sumber:
ASCIIEncoding.cs
Sumber:
ASCIIEncoding.cs

Menghitung jumlah karakter yang dihasilkan dengan mendekode rentang byte yang ditentukan.

public:
 override int GetCharCount(ReadOnlySpan<System::Byte> bytes);
public override int GetCharCount (ReadOnlySpan<byte> bytes);
override this.GetCharCount : ReadOnlySpan<byte> -> int
Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer

Parameter

bytes
ReadOnlySpan<Byte>

Rentang yang berisi set byte untuk didekodekan.

Mengembalikan

Jumlah karakter yang dihasilkan dengan mendekode rentang byte yang ditentukan.

Keterangan

Untuk menghitung ukuran yang tepat yang diperlukan oleh GetChars untuk menyimpan karakter yang dihasilkan, gunakan GetCharCount. Untuk menghitung ukuran maksimum, gunakan GetMaxCharCount. Metode ini GetCharCount umumnya memungkinkan alokasi lebih sedikit memori, sementara GetMaxCharCount metode umumnya dijalankan lebih cepat.

Berlaku untuk