ASCIIEncoding.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 Bytes ist größer als die maximale Zahl, die als ganze Zahl zurückgegeben werden kann.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die GetMaxCharCount Methode verwendet wird, um die maximale Anzahl von Zeichen zu berechnen, die zum Decodieren einer angegebenen Anzahl von Bytes erforderlich sind.
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
ASCIIEncoding ascii = new ASCIIEncoding();
int byteCount = 8;
int maxCharCount = ascii.GetMaxCharCount(byteCount);
Console.WriteLine(
"Maximum of {0} characters needed to decode {1} bytes.",
maxCharCount,
byteCount
);
}
}
Imports System.Text
Class ASCIIEncodingExample
Public Shared Sub Main()
Dim ascii As New ASCIIEncoding()
Dim byteCount As Integer = 8
Dim maxCharCount As Integer = ascii.GetMaxCharCount(byteCount)
Console.WriteLine( _
"Maximum of {0} characters needed to decode {1} bytes.", _
maxCharCount, _
byteCount _
)
End Sub
End Class
Hinweise
Die GetCharCount Methode berechnet die genaue Arraygröße, die von der GetChars Methode zum Speichern der resultierenden Zeichen benötigt wird, während die GetMaxCharCount Methode die maximale Arraygröße berechnet. Die GetCharCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.
GetMaxCharCount Ruft eine Worst-Case-Zahl ab, einschließlich des schlimmsten Falls für die aktuell ausgewählte DecoderFallback. Wenn ein Decoder-Fallback vorhanden ist, der eine maximale Fallbacklänge von n aufweist, gibt die GetMaxCharCount Methode n * byteCount zurück.
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).
