Sdílet prostřednictvím

UnicodeEncoding.GetMaxCharCount(Int32) Metoda

  • Reference

Definice

Obor názvů:
System.Text
Sestavení:
System.Text.Encoding.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
UnicodeEncoding.cs
Zdroj:
UnicodeEncoding.cs
Zdroj:
UnicodeEncoding.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 bajtů je větší než maximální počet, který lze vrátit jako celé číslo.

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 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()
{
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = 8;
   int maxCharCount = Unicode->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

using System;
using System.Text;

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

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = uni.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ě přiděluje méně paměti, zatímco GetMaxCharCount metoda se obecně spouští rychleji.

GetMaxCharCount Načte číslo nejhoršího případu, 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 načte velké hodnoty.

Ve většině případů tato metoda načte přiměřené počty malých řetězců. 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 GetCharCountConvert.

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).

Platí pro

Viz také