Udostępnij za pośrednictwem

UnicodeEncoding.GetMaxCharCount(Int32) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Text
Zestaw:
System.Text.Encoding.Extensions.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
UnicodeEncoding.cs
Źródło:
UnicodeEncoding.cs
Źródło:
UnicodeEncoding.cs

Oblicza maksymalną liczbę znaków generowanych przez dekodowanie określonej liczby bajtów.

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

Liczba bajtów do dekodowania.

Zwraca

Int32

Maksymalna liczba znaków generowanych przez dekodowanie określonej liczby bajtów.

Wyjątki

ArgumentOutOfRangeException

Parametr byteCount ma wartość niższą niż zero.

-lub-

Wynikowa liczba bajtów jest większa niż maksymalna liczba, którą można zwrócić jako liczbę całkowitą.

DecoderFallbackException

Wystąpił rezerwowy (aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET)

-I-

DecoderFallback jest ustawiona na DecoderExceptionFallbackwartość .

Przykłady

W poniższym przykładzie pokazano, jak za pomocą GetMaxCharCount metody zwracać maksymalną liczbę znaków generowanych przez dekodowanie określonej liczby bajtów.

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

Uwagi

Aby obliczyć dokładny rozmiar tablicy wymagany przez GetChars do przechowywania wynikowych znaków, aplikacja używa polecenia GetCharCount. Aby obliczyć maksymalny rozmiar tablicy, aplikacja powinna użyć polecenia GetMaxCharCount. Metoda GetCharCount zazwyczaj przydziela mniej pamięci, podczas gdy GetMaxCharCount metoda zwykle wykonuje się szybciej.

GetMaxCharCount pobiera najgorszy przypadek, w tym najgorszy przypadek dla aktualnie wybranego DecoderFallbackelementu . Jeśli rezerwowy zostanie wybrany z potencjalnie dużym ciągiem, GetMaxCharCount pobiera duże wartości.

W większości przypadków ta metoda pobiera rozsądne liczby dla małych ciągów. W przypadku dużych ciągów może być konieczne wybranie między użyciem bardzo dużych buforów a błędami przechwytywania w rzadkich przypadkach przekroczenia bardziej rozsądnego buforu. Warto również rozważyć inne podejście przy użyciu metody GetCharCount lub Convert.

GetMaxCharCount nie ma relacji z GetBytes. Jeśli aplikacja potrzebuje podobnej funkcji do użycia z GetBytesprogramem , powinna użyć polecenia GetMaxByteCount.

Uwaga

GetMaxCharCount(N) niekoniecznie jest taką samą wartością jak N* GetMaxCharCount(1).

Dotyczy

Zobacz też