Encoder.GetByteCount Metode

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter.

Overload

GetByteCount(ReadOnlySpan<Char>, Boolean)	Ketika ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dalam rentang 'karakter'. Parameter menunjukkan apakah akan menghapus status internal encoder setelah perhitungan.
GetByteCount(Char*, Int32, Boolean)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan. Parameter menunjukkan apakah akan menghapus status internal encoder setelah perhitungan.
GetByteCount(Char[], Int32, Int32, Boolean)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan. Parameter menunjukkan apakah akan menghapus status internal encoder setelah perhitungan.

Keterangan

Metode ini tidak mempengaruhi status encoder.

Untuk menghitung ukuran array yang tepat yang GetBytes mengharuskan untuk menyimpan byte yang dihasilkan, aplikasi harus menggunakan GetByteCount.

Jika GetBytes dipanggil dengan flush diatur ke false, encoder menyimpan karakter berikutnya di akhir blok data dalam buffer internal dan menggunakannya dalam operasi pengodean berikutnya. Aplikasi harus memanggil GetByteCount blok data segera sebelum memanggil GetBytes pada blok yang sama, sehingga setiap karakter berikutnya dari blok sebelumnya disertakan dalam perhitungan.

GetByteCount(ReadOnlySpan<Char>, Boolean)

Sumber:

Encoder.cs

Ketika ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dalam rentang 'karakter'. Parameter menunjukkan apakah akan menghapus status internal encoder setelah perhitungan.

public:
 virtual int GetByteCount(ReadOnlySpan<char> chars, bool flush);

public virtual int GetByteCount (ReadOnlySpan<char> chars, bool flush);

abstract member GetByteCount : ReadOnlySpan<char> * bool -> int
override this.GetByteCount : ReadOnlySpan<char> * bool -> int

Public Overridable Function GetByteCount (chars As ReadOnlySpan(Of Char), flush As Boolean) As Integer

Parameter

chars

ReadOnlySpan<Char>

Rentang karakter untuk dikodekan.

flush

Boolean

true untuk menyimulasikan pembersihan status internal encoder setelah perhitungan; jika tidak, false.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan karakter yang ditentukan dan karakter apa pun di buffer internal.

GetByteCount(Char*, Int32, Boolean)

Sumber:

Encoder.cs

Penting

API ini bukan kompatibel CLS.

Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan. Parameter menunjukkan apakah akan menghapus status internal encoder setelah perhitungan.

public:
 virtual int GetByteCount(char* chars, int count, bool flush);

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

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

Parameter

chars

Char*

Penunjuk ke karakter pertama yang akan dikodekan.

count

Int32

Jumlah karakter yang akan dikodekan.

flush

Boolean

true untuk menyimulasikan pembersihan status internal encoder setelah perhitungan; jika tidak, false.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan karakter yang ditentukan dan karakter apa pun di buffer internal.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

chars adalah null (Nothing dalam Visual Basic .NET).

ArgumentOutOfRangeException

count kurang dari nol.

EncoderFallbackException

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

-dan-

Fallback diatur ke EncoderExceptionFallback.

Lihat juga

• GetBytes(Char*, Int32, Byte*, Int32, Boolean)
• Reset()

GetByteCount(Char[], Int32, Int32, Boolean)

Sumber:

Encoder.cs

Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan. Parameter menunjukkan apakah akan menghapus status internal encoder setelah perhitungan.

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

public abstract int GetByteCount (char[] chars, int index, int count, bool flush);

abstract member GetByteCount : char[] * int * int * bool -> int

Public MustOverride Function GetByteCount (chars As Char(), index As Integer, count As Integer, flush As Boolean) 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.

flush

Boolean

true untuk menyimulasikan pembersihan status internal encoder setelah perhitungan; jika tidak, false.

Mengembalikan

Int32

Jumlah byte yang dihasilkan dengan mengodekan karakter yang ditentukan dan karakter apa pun di buffer internal.

Pengecualian

ArgumentNullException

charsadalah null.

ArgumentOutOfRangeException

index atau count kurang dari nol.

-atau-

index dan count tidak menunjukkan rentang yang valid dalam chars.

EncoderFallbackException

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

-dan-

Fallback diatur ke EncoderExceptionFallback.

Contoh

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

using namespace System;
using namespace System::Text;
int main()
{
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   Encoder^ uniEncoder = Encoding::Unicode->GetEncoder();
   int byteCount = uniEncoder->GetByteCount( chars, 0, chars->Length, true );
   Console::WriteLine( "{0} bytes needed to encode characters.", byteCount );
}

/* This code example produces the following output. 

8 bytes needed to encode characters.

*/

using System;
using System.Text;

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

        Encoder uniEncoder = Encoding.Unicode.GetEncoder();
        int byteCount = uniEncoder.GetByteCount(chars, 0, chars.Length, true);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

/* This example produces the following output.

8 bytes needed to encode characters.

*/

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class EncoderExample
    
    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 uniEncoder As Encoder = Encoding.Unicode.GetEncoder()
        Dim byteCount As Integer = _
            uniEncoder.GetByteCount(chars, 0, chars.Length, True)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class
'
'This example produces the following output.
'
'8 bytes needed to encode characters.
'

Lihat juga

• GetBytes(Char[], Int32, Int32, Byte[], Int32, Boolean)
• Reset()