ASCIIEncoding.GetMaxByteCount(Int32) Metoda

Definice

Obor názvů:

System.Text

Sestavení:

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

Zdroj:

ASCIIEncoding.cs

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í zakó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 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 požadovanou GetBytes metodou k uložení výsledných bajtů, zatímco GetMaxByteCount metoda vypočítá maximální velikost pole. Metoda GetByteCount obvykle 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í položku 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 vlastní náhradní náhradní znak byl 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 pro použití s GetChars, měla by použít GetMaxCharCount.

Note

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

Viz také

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