ASCIIEncoding.GetMaxByteCount(Int32) Metode

Definisi

Ruang nama:

System.Text

Rakitan:

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

Sumber:

ASCIIEncoding.cs

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

public:
 override int GetMaxByteCount(int charCount);

public override int GetMaxByteCount(int charCount);

override this.GetMaxByteCount : int -> int

Public Overrides Function GetMaxByteCount (charCount As Integer) As Integer

Parameter

charCount

Int32

Jumlah karakter yang akan dikodekan.

Mengembalikan

Int32

Jumlah maksimum byte yang dihasilkan dengan mengodekan jumlah karakter yang ditentukan.

Pengecualian

ArgumentOutOfRangeException

charCount kurang dari nol.

-atau-

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

Contoh

Contoh berikut menunjukkan cara menggunakan GetMaxByteCount metode untuk menghitung byte yang diperlukan untuk mengodekan jumlah karakter tertentu.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        ASCIIEncoding ascii = new ASCIIEncoding();
        int charCount = 2;
        int maxByteCount = ascii.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim ascii As New ASCIIEncoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = ascii.GetMaxByteCount(charCount)
        Console.WriteLine( _
            "Maximum of {0} bytes needed to encode {1} characters.", _
            maxByteCount, _
            charCount _
        )
    End Sub
End Class

Keterangan

Metode menghitung GetByteCount ukuran array yang tepat yang diperlukan oleh GetBytes metode untuk menyimpan byte yang dihasilkan, sedangkan GetMaxByteCount metode menghitung ukuran array maksimum. Metode ini GetByteCount umumnya mengalokasikan lebih sedikit memori, tetapi metode ini GetMaxByteCount umumnya dijalankan lebih cepat.

GetMaxByteCount adalah angka kasus terburuk, termasuk kasus terburuk untuk yang saat ini dipilih EncoderFallback. Jika Anda memilih fallback pengganti dengan string yang berpotensi besar, GetMaxByteCount dapat mengembalikan nilai besar.

Metode ini GetMaxByteCount mempertimbangkan potensi pengganti sisa dari operasi pengodean sebelumnya. Akibatnya, jika ASCIIEncoding objek menggunakan fallback penggantian default, atau jika fallback penggantian kustom telah ditentukan dengan satu kemungkinan karakter fallback, metode mengembalikan charCount + 1. ASCIIEncoding Jika objek menggunakan fallback pengganti dengan lebih dari satu kemungkinan karakter fallback, metode mengembalikan n * (charCount + 1), di mana n adalah jumlah maksimum karakter fallback.

GetMaxByteCount tidak memiliki hubungan dengan GetChars. Jika aplikasi Anda memerlukan fungsi serupa untuk digunakan dengan GetChars, aplikasi harus menggunakan GetMaxCharCount.

Note

GetMaxByteCount(N) belum tentu nilai yang sama dengan N* GetMaxByteCount(1).

Lihat juga

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetEncoder()