UnicodeEncoding.GetMaxByteCount(Int32) Methode

Definition

Namespace:
System.Text
Assemblys:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
netstandard.dll

Berechnet die maximale Anzahl von Byte, die durch die Codierung der angegebenen Anzahl von Zeichen erzeugt werden.

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 von Byte, die durch die Codierung der angegebenen Anzahl von Zeichen erzeugt werden.

Ausnahmen

ArgumentOutOfRangeException

charCount ist kleiner als 0 (null).

-oder-

Die resultierende Anzahl von Bytes ist größer als die maximale Zahl, die als ganze Zahl zurückgegeben werden kann.

EncoderFallbackException

Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")

-und-

EncoderFallback ist auf EncoderExceptionFallback festgelegt.

Beispiele

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

using System;
using System.Text;

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

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = uni.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, verwendet GetByteCountdie Anwendung . Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxByteCount. Die GetByteCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.

GetMaxByteCount Ruft eine Worst-Case-Zahl ab, einschließlich des schlimmsten Falls für die aktuell ausgewählte 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 ruft diese Methode angemessene Zahlen für kleine Zeichenfolgen ab. Bei großen Zeichenfolgen müssen Sie möglicherweise zwischen der Verwendung sehr großer Puffer und dem Abfangen von Fehlern im seltenen Fall wählen, dass ein angemessenerer Puffer überschritten wird. Möglicherweise möchten Sie auch einen anderen Ansatz in Betracht ziehen, der verwendet GetByteCount oder verwendet wird Encoder.Convert.

GetMaxByteCount hat keine Beziehung zu GetChars. Wenn Ihre Anwendung eine ähnliche Funktion benötigt, mit GetCharsder sie verwendet werden soll, sollte sie verwendet werden GetMaxCharCount.

Note

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

Gilt für:

Weitere Informationen