ASCIIEncoding.GetMaxByteCount(Int32) Metoda

  • Reference

Definice

Obor názvů:
System.Text
Sestavení:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Sestavení:
System.Text.Encoding.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Vypočítá maximální počet bajtů vytvořených kódováním zadaného počtu znaků.

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

Parametry

charCount
Int32

Počet znaků, které se mají kódovat.

Návraty

Int32

Maximální počet bajtů vytvořených kódováním zadaného počtu znaků.

Výjimky

ArgumentOutOfRangeException

Hodnota charCount je menší než nula.

-nebo- Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako celé číslo.

Příklady

Následující příklad ukazuje, jak použít metodu GetMaxByteCount k výpočtu bajtů potřebných ke kódování zadaného počtu znaků.

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

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

Poznámky

Metoda GetByteCount vypočítá přesnou velikost pole vyžadovanou GetBytes metodou k uložení výsledných bajtů, zatímco GetMaxByteCount metoda vypočítá maximální velikost pole. Metoda GetByteCount obecně přiděluje méně paměti, ale GetMaxByteCount metoda obvykle provádí rychleji.

GetMaxByteCount je číslo nejhoršího případu, včetně nejhoršího případu aktuálně vybraného EncoderFallback. Pokud zvolíte náhradní náhradní řetězec s potenciálně velkým řetězcem, GetMaxByteCount může vrátit velké hodnoty.

Metoda GetMaxByteCount bere v úvahu potenciální náhradní náhrady z předchozí operace kódování. V důsledku toho, pokud ASCIIEncoding objekt používá výchozí náhradní náhradní, nebo pokud byl vlastní náhradní náhradní znak definován s jedním možným náhradním znakem, metoda vrátí charCount + 1. ASCIIEncoding Pokud objekt používá náhradní náhradní znak s více než jedním možným náhradním znakem, vrátí metoda n * (charCount + 1), kde n je maximální počet náhradních znaků.

GetMaxByteCount nemá žádný vztah k GetChars. Pokud vaše aplikace potřebuje podobnou funkci, která se má použít GetChars, měla by použít GetMaxCharCount.

Poznámka

GetMaxByteCount(N) nemusí být nutně stejná hodnota jako N* GetMaxByteCount(1).

Platí pro

Viz také