ASCIIEncoding.GetMaxByteCount(Int32) Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kodlar:

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

Kaynak:

ASCIIEncoding.cs

Belirtilen karakter sayısını kodlayarak üretilen en fazla bayt sayısını hesaplar.

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

Parametreler

charCount

Int32

Kodlanacak karakter sayısı.

Döndürülenler

Int32

Belirtilen karakter sayısını kodlayarak üretilen bayt sayısı üst sınırı.

Özel durumlar

ArgumentOutOfRangeException

charCount, sıfırdan küçüktür.

-veya-

Elde edilen bayt sayısı, tamsayı olarak döndürülebilecek maksimum sayıdan büyüktür.

Örnekler

Aşağıdaki örnek, belirtilen sayıda karakteri kodlamak için gereken baytları hesaplamak için yönteminin nasıl kullanılacağını GetMaxByteCount gösterir.

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

Açıklamalar

GetByteCount yöntemi, elde edilen baytları depolamak için yöntemin GetBytes gerektirdiği dizi boyutunu tam olarak hesaplarkenGetMaxByteCount, yöntem en büyük dizi boyutunu hesaplar. GetByteCount yöntemi genellikle daha az bellek ayırır, ancak GetMaxByteCount yöntem genellikle daha hızlı yürütülür.

GetMaxByteCount , seçili EncoderFallbackdurumdaki için en kötü durum da dahil olmak üzere en kötü durumlu bir sayıdır. Büyük olabilecek bir dizeye sahip yeni bir geri dönüş seçerseniz, GetMaxByteCount büyük değerler döndürebilir.

yöntemi, GetMaxByteCount önceki bir kodlama işleminden kalan olası yedekleri dikkate alır. Sonuç olarak, nesne varsayılan değiştirme geri dönüşünü kullanıyorsa ASCIIEncoding veya tek bir olası geri dönüş karakteriyle özel bir değiştirme geri dönüş tanımlandıysa, yöntem + 1 döndürür charCount . ASCIIEncoding Nesne, birden fazla olası geri dönüş karakteriyle yedek bir geri dönüş kullanırsa, yöntem n * (charCount + 1) döndürür; burada n, en fazla geri dönüş karakteri sayısıdır.

GetMaxByteCount ile hiçbir ilişkisi GetCharsyoktur. Uygulamanızın ile GetCharskullanmak için benzer bir işleve ihtiyacı varsa, bunu kullanmalıdır GetMaxCharCount.

Note

GetMaxByteCount(N) ile aynı değer N* GetMaxByteCount(1)olmayabilir.

Ayrıca bkz.

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