ASCIIEncoding.GetMaxCharCount(Int32) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Text
Zestawy:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Zestaw:
System.Text.Encoding.Extensions.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

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

Przykłady

W poniższym przykładzie pokazano, jak użyć GetMaxCharCount metody do obliczenia maksymalnej liczby znaków wymaganych do zdekodowania określonej liczby bajtów.

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

using System;
using System.Text;

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

Imports System.Text

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

Uwagi

Metoda GetCharCount oblicza dokładny rozmiar tablicy wymagany przez GetChars metodę do przechowywania znaków wynikowych, natomiast GetMaxCharCount metoda oblicza maksymalny rozmiar tablicy. Metoda GetCharCount zwykle przydziela mniej pamięci, podczas gdy GetMaxCharCount metoda zwykle wykonuje się szybciej.

GetMaxCharCount pobiera numer najgorszej wielkości liter, w tym najgorszy przypadek dla aktualnie wybranego DecoderFallbackelementu . Jeśli rezerwowy dekoder jest obecny, który ma maksymalną długość rezerwową n, GetMaxCharCount metoda zwraca n * byteCount.

GetMaxCharCountnie ma relacji z .GetBytes Jeśli aplikacja potrzebuje podobnej funkcji do użycia z usługą GetBytes, powinna używać polecenia GetMaxByteCount.

Uwaga

GetMaxCharCount(N) nie musi być tą samą wartością co N* GetMaxCharCount(1).

Dotyczy

Zobacz też