UTF7Encoding.GetMaxCharCount(Int32) Metoda

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Zdroj:

UTF7Encoding.cs

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

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

Parametry

byteCount

Int32

Počet bajtů k dekódování.

Návraty

Int32

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

Výjimky

ArgumentOutOfRangeException

Hodnota byteCount je menší než nula.

-nebo-

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

DecoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET)

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu ukazuje, jak použít metodu GetMaxCharCount k vrácení maximálního počtu znaků produkovaných dekódováním zadaného počtu bajtů.

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

using System;
using System.Text;

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

Imports System.Text

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

Poznámky

K výpočtu přesné velikosti pole potřebné GetChars k uložení výsledných znaků aplikace používá GetCharCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda se obecně spouští rychleji.

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

Ve většině případů tato metoda vrátí přiměřené hodnoty pro malé řetězce. U velkých řetězců si možná budete muset vybrat mezi použitím velmi velkých vyrovnávacích pamětí a zachycením chyb ve výjimečných případech, kdy dojde k překročení rozumnější vyrovnávací paměti. Můžete také zvážit jiný přístup pomocí nebo GetCharCountDecoder.Convert.

GetMaxCharCount nemá žádný vztah k GetBytes. Pokud vaše aplikace potřebuje podobnou funkci pro použití s GetBytes, měla by používat GetMaxByteCount.

Poznámka

GetMaxCharCount(N) není nutně stejná hodnota jako N* GetMaxCharCount(1).

Viz také

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetString(Byte[], Int32, Int32)
• GetCharCount(Byte[], Int32, Int32)
• GetDecoder()