UTF7Encoding.GetMaxByteCount(Int32) Metoda

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

System.Text.Encoding.Extensions.dll

Źródło:

UTF7Encoding.cs

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

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

Liczba znaków do zakodowania.

Zwraca

Int32

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

Wyjątki

ArgumentOutOfRangeException

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

EncoderFallbackException

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

-I-

EncoderFallback parametr jest ustawiony na EncoderExceptionFallbackwartość .

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą GetMaxByteCount metody zwracać maksymalną liczbę bajtów wymaganych do zakodowania określonej liczby znaków.

using namespace System;
using namespace System::Text;
int main()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int charCount = 2;
   int maxByteCount = utf7->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        int charCount = 2;
        int maxByteCount = utf7.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = utf7.GetMaxByteCount(charCount)
        Console.WriteLine( _
            "Maximum of {0} bytes needed to encode {1} characters.", _
            maxByteCount, _
            charCount _
        )
    End Sub
End Class

Uwagi

Aby obliczyć dokładny rozmiar tablicy wymagany przez GetBytes program do przechowywania wynikowych bajtów, aplikacja używa elementu GetByteCount. Aby obliczyć maksymalny rozmiar tablicy, aplikacja powinna używać polecenia GetMaxByteCount. Metoda GetByteCount zwykle zezwala na alokację mniejszej ilości pamięci, podczas gdy GetMaxByteCount metoda zwykle wykonuje się szybciej.

GetMaxByteCount jest numerem najgorszej wielkości liter, w tym najgorszym przypadkiem dla aktualnie wybranego EncoderFallbackelementu . Jeśli zostanie wybrany rezerwowy z potencjalnie dużym ciągiem, GetMaxByteCount może zwrócić duże wartości.

W większości przypadków ta metoda zwraca rozsądne liczby dla małych ciągów. W przypadku dużych ciągów może być konieczne wybranie między używaniem bardzo dużych buforów a przechwytywaniem błędów w rzadkich przypadkach przekroczenia bardziej rozsądnego buforu. Warto również rozważyć inne podejście przy użyciu metody GetByteCount lub Encoder.Convert. Chociaż funkcja UTF-7 jest bardzo wydajna podczas kodowania danych ASCII, jeden bajt na znak jest niezwykle nieefektywny dla innych danych. Jak zauważył powyżej, GetMaxByteCount zajmuje się najgorszym przypadkiem. Jeśli dane do zakodowania są w dużej mierze ASCII, a zwłaszcza jeśli znaki ASCII klaster razem, UTF-7 jest znacznie wydajniejszy niż liczba zwracana przez tę metodę.

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

Uwaga

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

Zobacz też

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