UTF7Encoding.GetMaxByteCount(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> intPublic Overrides Function GetMaxByteCount (charCount As Integer) As IntegerParameter
- charCount
- Int32
Die Anzahl der zu codierenden Zeichen.
Gibt zurück
Die maximale Anzahl von Byte, die durch die Codierung der angegebenen Anzahl von Zeichen erzeugt werden.
Ausnahmen
charCount ist kleiner als 0 (null).
-oder-
Die resultierende Anzahl von Bytes ist größer als die maximale Anzahl, die als Int zurückgegeben werden kann.
Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")
-und-
EncoderFallback ist auf EncoderExceptionFallback festgelegt.
Beispiele
Im folgenden Codebeispiel 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 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
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 ermöglicht in der Regel die Zuordnung von weniger Arbeitsspeicher, während die GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.
GetMaxByteCount ist eine Worst-Case-Zahl, 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 gibt diese Methode angemessene Zahlen für kleine Zeichenfolgen zurück. 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. Während UTF-7 bei der Codierung von ASCII-Daten sehr effizient ist, ist es für andere Daten äußerst ineffizient, ein Byte pro Zeichen. Wie oben erwähnt, GetMaxByteCount handelt es sich um einen schlimmsten Fall. Wenn die zu codierenden Daten größtenteils ASCII sind und insbesondere dann, wenn die ASCII-Zeichen zusammen clustern, ist UTF-7 wesentlich effizienter als die von dieser Methode zurückgegebene Zahl.
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).
