ASCIIEncoding.GetByteCount Metode

Definisi

Ruang nama:

System.Text

Rakitan:

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

Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter.

Overload

Nama	Deskripsi
GetByteCount(ReadOnlySpan<Char>)	Menghitung jumlah byte yang dihasilkan dengan mengodekan rentang karakter yang ditentukan.
GetByteCount(String)	Menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam String.
GetByteCount(Char*, Int32)	Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan.
GetByteCount(Char[], Int32, Int32)	Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan.

GetByteCount(ReadOnlySpan<Char>)

Sumber:

ASCIIEncoding.cs

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

public:
 override int GetByteCount(ReadOnlySpan<char> chars);

public override int GetByteCount(ReadOnlySpan<char> chars);

override this.GetByteCount : ReadOnlySpan<char> -> int

Public Overrides Function GetByteCount (chars As ReadOnlySpan(Of Char)) As Integer

Parameter

chars

ReadOnlySpan<Char>

Rentang yang berisi sekumpulan karakter untuk dikodekan.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan rentang karakter yang ditentukan.

Keterangan

Untuk menghitung ukuran tepat yang diperlukan oleh GetBytes untuk menyimpan byte yang dihasilkan, gunakan GetByteCount. Untuk menghitung ukuran maksimum, gunakan GetMaxByteCount. Metode ini GetByteCount umumnya memungkinkan alokasi lebih sedikit memori, sementara GetMaxByteCount metode umumnya dijalankan lebih cepat.

GetByteCount(String)

Sumber:

ASCIIEncoding.cs

Menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam String.

public:
 override int GetByteCount(System::String ^ chars);

public override int GetByteCount(string chars);

override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (chars As String) As Integer

Parameter

chars

String

yang String berisi sekumpulan karakter yang akan dikodekan.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan karakter yang ditentukan.

Pengecualian

ArgumentNullException

chars adalah null.

ArgumentOutOfRangeException

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

EncoderFallbackException

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

-dan-

EncoderFallback diatur ke EncoderExceptionFallback.

Contoh

Contoh berikut menunjukkan cara menggunakan GetByteCount metode untuk mengembalikan jumlah byte yang diperlukan untuk mengodekan string menggunakan ASCIIEncoding.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        String chars = "ASCII Encoding Example";

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars);
        Console.WriteLine(
            "{0} bytes needed to encode string.", byteCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars)
        Console.WriteLine("{0} bytes needed to encode string.", byteCount)
    End Sub
End Class

Keterangan

Untuk menghitung ukuran array yang tepat yang diperlukan oleh GetBytes untuk menyimpan byte yang dihasilkan, aplikasi menggunakan GetByteCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxByteCount. Metode ini GetByteCount umumnya memungkinkan alokasi lebih sedikit memori, sementara GetMaxByteCount metode umumnya dijalankan lebih cepat.

Lihat juga

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()
• Memahami Pengodean

GetByteCount(Char*, Int32)

Sumber:

ASCIIEncoding.cs

Penting

API ini bukan kompatibel CLS.

Alternatif kompatibel CLS

System.Text.ASCIIEncoding.GetByteCount(Char[], Int32, Int32)

Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan.

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
public override int GetByteCount(char* chars, int count);

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

Parameter

chars

Char*

Penunjuk ke karakter pertama yang akan dikodekan.

count

Int32

Jumlah karakter yang akan dikodekan.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan karakter yang ditentukan.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

chars adalah null.

ArgumentOutOfRangeException

count kurang dari nol.

-atau-

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

EncoderFallbackException

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

-dan-

EncoderFallback diatur ke EncoderExceptionFallback.

Keterangan

Untuk menghitung ukuran array yang tepat yang diperlukan oleh GetBytes untuk menyimpan byte yang dihasilkan, aplikasi menggunakan GetByteCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxByteCount. Metode ini GetByteCount umumnya memungkinkan alokasi lebih sedikit memori, sementara GetMaxByteCount metode umumnya dijalankan lebih cepat.

Lihat juga

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()

GetByteCount(Char[], Int32, Int32)

Sumber:

ASCIIEncoding.cs

Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan.

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);

public override int GetByteCount(char[] chars, int index, int count);

override this.GetByteCount : char[] * int * int -> int

Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Parameter

chars

Char[]

Array karakter yang berisi sekumpulan karakter untuk dikodekan.

index

Int32

Indeks karakter pertama yang dikodekan.

count

Int32

Jumlah karakter yang akan dikodekan.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan karakter yang ditentukan.

Pengecualian

ArgumentNullException

chars adalah null.

ArgumentOutOfRangeException

index atau count kurang dari nol.

-atau-

index dan count jangan menandakan rentang yang valid di chars.

-atau-

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

EncoderFallbackException

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

-dan-

EncoderFallback diatur ke EncoderExceptionFallback.

Contoh

Contoh berikut menunjukkan cara menggunakan GetByteCount metode untuk mengembalikan jumlah byte yang diperlukan untuk mengodekan array karakter Unicode menggunakan ASCIIEncoding.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Keterangan

Untuk menghitung ukuran array yang tepat yang diperlukan oleh GetBytes untuk menyimpan byte yang dihasilkan, aplikasi menggunakan GetByteCount. Untuk menghitung ukuran array maksimum, aplikasi harus menggunakan GetMaxByteCount. Metode ini GetByteCount umumnya memungkinkan alokasi lebih sedikit memori, sementara GetMaxByteCount metode umumnya dijalankan lebih cepat.

Lihat juga

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()