UTF8Encoding.GetMaxByteCount(Int32) Methode

Definition

Namespace:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Quelle:

UTF8Encoding.cs

Berechnet die maximale Anzahl der Bytes, die beim Codieren der angegebenen Anzahl von Zeichen erzeugt wird.

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

Parameter

charCount

Int32

Die Anzahl der zu codierenden Zeichen.

Gibt zurück

Int32

Die maximale Anzahl an Bytes, die beim Codieren der angegebenen Anzahl von Zeichen erzeugt werden.

Ausnahmen

ArgumentOutOfRangeException

charCount ist kleiner als Null.

- oder -

Die sich ergebende Anzahl von Bytes ist höher als die maximale Anzahl, die als ganze Zahl zurückgegeben werden kann.

EncoderFallbackException

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET).

- und -

Für EncoderFallback ist EncoderExceptionFallback festgelegt.

Beispiele

Im folgenden Beispiel wird die GetMaxByteCount -Methode verwendet, um die maximale Anzahl von Bytes zurückzugeben, die zum Codieren einer angegebenen Anzahl von Zeichen erforderlich ist.

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

using System;
using System.Text;

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

Imports System.Text

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

Hinweise

Um die genaue Arraygröße zu berechnen, die zum GetBytes Speichern der resultierenden Bytes erforderlich ist, rufen Sie die -Methode auf GetByteCount . Um die maximale Arraygröße zu berechnen, rufen Sie die -Methode auf GetMaxByteCount . Die GetByteCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.

GetMaxByteCount ist eine Worst-Case-Zahl, einschließlich des schlechtesten Falls für den derzeit ausgewählten EncoderFallback. Wenn ein Fallback mit einer potenziell großen Zeichenfolge ausgewählt wird, GetMaxByteCount können große Werte zurückgegeben werden.

In den meisten Fällen gibt diese Methode angemessene Zahlen für kleine Zeichenfolgen zurück. Bei großen Zeichenfolgen müssen Sie sich möglicherweise zwischen der Verwendung sehr großer Puffer und dem Abfangen von Fehlern entscheiden, wenn ein vernünftigerer Puffer überschritten wird. Möglicherweise möchten Sie auch einen anderen Ansatz mithilfe von GetByteCount oder betrachten Encoder.Convert . Beispielsweise benötigt Text in Englisch und vielen anderen Sprachen oft nur ein UTF-8-Byte, um ein Zeichen darzustellen, aber die von zurückgegebene Zahl muss die Möglichkeit zulassen, dass die zu konvertierende GetMaxByteCount Zeichenfolge vollständig aus Zeichen besteht, die jeweils vier Bytes erfordern.

GetMaxByteCounthat keine Beziehung zu GetChars . Wenn Ihre Anwendung eine ähnliche Funktion für die Verwendung mit GetCharsbenötigt, sollte sie verwenden GetMaxCharCount.

Hinweis

GetMaxByteCount(N)ist nicht notwendigerweise derselbe Wert wie N* GetMaxByteCount(1) .

Weitere Informationen

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