UTF7Encoding.GetMaxByteCount(Int32) Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Kaynak:

UTF7Encoding.cs

Belirtilen karakter sayısını kodlayarak üretilen bayt sayısı üst sınırı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ı, int olarak döndürülebilecek maksimum sayıdan büyüktür.

EncoderFallbackException

Bir geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Örnekler

Aşağıdaki kod örneği, belirtilen sayıda karakteri kodlamak için gereken en fazla bayt sayısını döndürmek için yönteminin nasıl kullanılacağını GetMaxByteCount gösterir.

using namespace System;
using namespace System::Text;
int main()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int charCount = 2;
   int maxByteCount = utf7->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

using System;
using System.Text;

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

Imports System.Text

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

Açıklamalar

Uygulama, sonuç baytlarını depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için kullanır GetByteCount. En büyük dizi boyutunu hesaplamak için, uygulama kullanmalıdır GetMaxByteCount. GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.

GetMaxByteCount , şu anda seçili EncoderFallbackolan için en kötü durum dahil olmak üzere en kötü durumlu bir sayıdır. Büyük olabilecek bir dize ile bir geri dönüş seçilirse, GetMaxByteCount büyük değerler döndürebilir.

Çoğu durumda, bu yöntem küçük dizeler için makul sayılar döndürür. Büyük dizeler için, çok büyük arabellekler kullanma ve daha makul bir arabelleğin aşılması durumunda hataları yakalama arasında seçim yapmanız gerekebilir. veya Encoder.Convertkullanarak GetByteCount farklı bir yaklaşımı da göz önünde bulundurmak isteyebilirsiniz. UTF-7, karakter başına bir bayt olan ASCII verilerini kodlamada çok verimli olsa da, diğer veriler için son derece verimsizdir. Yukarıda belirtildiği gibi, GetMaxByteCount en kötü durumla ilgilenir. Kodlanacak veriler büyük ölçüde ASCII ise ve özellikle de ASCII karakterleri birlikte kümeleniyorsa, UTF-7 bu yöntem tarafından döndürülen sayıdan önemli ölçüde daha verimlidir.

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

Not

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

Ayrıca bkz.

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