ASCIIEncoding.GetMaxCharCount(Int32) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Text
Bütünleştirilmiş Kodlar:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Bütünleştirilmiş Kod:
System.Text.Encoding.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Belirtilen bayt sayısının kodunu çözerek üretilen en fazla karakter sayısını hesaplar.

public:
 override int GetMaxCharCount(int byteCount);
public override int GetMaxCharCount (int byteCount);
override this.GetMaxCharCount : int -> int
Public Overrides Function GetMaxCharCount (byteCount As Integer) As Integer

Parametreler

byteCount
Int32

Kodu çözecek bayt sayısı.

Döndürülenler

Int32

Belirtilen bayt sayısının kodunun çözülmesiyle oluşturulan en fazla karakter sayısı.

Özel durumlar

ArgumentOutOfRangeException

byteCount, 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 bayt kodunu GetMaxCharCount çözmek için gereken en fazla karakter sayısını hesaplamak için yönteminin nasıl kullanılacağını gösterir.

using namespace System;
using namespace System::Text;
int main()
{
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = 8;
   int maxCharCount = ascii->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = 8;
        int maxCharCount = ascii.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = ascii.GetMaxCharCount(byteCount)
        Console.WriteLine( _
            "Maximum of {0} characters needed to decode {1} bytes.", _
            maxCharCount, _
            byteCount _
        )
    End Sub
End Class

Açıklamalar

yöntemi, GetCharCount elde edilen karakterleri depolamak için yöntemin GetChars gerektirdiği dizi boyutunu tam olarak hesaplarken GetMaxCharCount , yöntem en büyük dizi boyutunu hesaplar. GetCharCount yöntemi genellikle daha az bellek ayırırkenGetMaxCharCount, yöntem genellikle daha hızlı yürütülür.

GetMaxCharCount seçili durumdaki DecoderFallbackiçin en kötü durum dahil olmak üzere en kötü durum numarasını alır. Maksimum geri dönüş uzunluğu n olan bir kod çözücü geri dönüş varsa, GetMaxCharCount yöntemi n * byteCount döndürür.

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

Not

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

Şunlara uygulanır

Ayrıca bkz.