UTF7Encoding.GetMaxCharCount(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 Zeichen, die durch Decodieren der angegebenen Anzahl von Bytes erzeugt werden.
public:
override int GetMaxCharCount(int byteCount);public override int GetMaxCharCount(int byteCount);override this.GetMaxCharCount : int -> intPublic Overrides Function GetMaxCharCount (byteCount As Integer) As IntegerParameter
- byteCount
- Int32
Die Anzahl der Bytes, die decodiert werden sollen.
Gibt zurück
Die maximale Anzahl von Zeichen, die durch Decodieren der angegebenen Anzahl von Bytes erzeugt werden.
Ausnahmen
byteCount ist kleiner als 0 (null).
-oder-
Die resultierende Anzahl von Zeichen 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-
DecoderFallback ist auf DecoderExceptionFallback festgelegt.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die GetMaxCharCount Methode verwendet wird, um die maximale Anzahl von Zeichen zurückzugeben, die durch Decodieren einer angegebenen Anzahl von Bytes erzeugt werden.
using System;
using System.Text;
class UTF7EncodingExample {
public static void Main() {
UTF7Encoding utf7 = new UTF7Encoding();
int byteCount = 8;
int maxCharCount = utf7.GetMaxCharCount(byteCount);
Console.WriteLine(
"Maximum of {0} characters needed to decode {1} bytes.",
maxCharCount,
byteCount
);
}
}
Imports System.Text
Class UTF7EncodingExample
Public Shared Sub Main()
Dim utf7 As New UTF7Encoding()
Dim byteCount As Integer = 8
Dim maxCharCount As Integer = utf7.GetMaxCharCount(byteCount)
Console.WriteLine( _
"Maximum of {0} characters needed to decode {1} bytes.", _
maxCharCount, _
byteCount _
)
End Sub
End Class
Hinweise
Um die genaue Arraygröße zu berechnen, die zum GetChars Speichern der resultierenden Zeichen erforderlich ist, verwendet GetCharCountdie Anwendung . Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxCharCount. Die GetCharCount Methode ermöglicht in der Regel die Zuordnung von weniger Arbeitsspeicher, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.
GetMaxCharCount ist eine Worst-Case-Zahl, einschließlich des schlimmsten Falls für die aktuell ausgewählte DecoderFallback. Wenn ein Fallback mit einer potenziell großen Zeichenfolge ausgewählt wird, GetMaxCharCount 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 GetCharCount oder verwendet wird Decoder.Convert.
GetMaxCharCount hat keine Beziehung zu GetBytes. Wenn Ihre Anwendung eine ähnliche Funktion benötigt, mit GetBytesder sie verwendet werden soll, sollte sie verwendet werden GetMaxByteCount.
Note
GetMaxCharCount(N) ist nicht unbedingt derselbe Wert wie N* GetMaxCharCount(1).
