ASCIIEncoding.GetMaxCharCount(Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Berekent het maximum aantal tekens dat wordt geproduceerd door het opgegeven aantal bytes te decoderen.
public:
override int GetMaxCharCount(int byteCount);public override int GetMaxCharCount(int byteCount);override this.GetMaxCharCount : int -> intPublic Overrides Function GetMaxCharCount (byteCount As Integer) As IntegerParameters
- byteCount
- Int32
Het aantal bytes dat moet worden gedecodeerd.
Retouren
Het maximum aantal tekens dat wordt geproduceerd door het opgegeven aantal bytes te decoderen.
Uitzonderingen
byteCount is kleiner dan nul.
– of –
Het resulterende aantal bytes is groter dan het maximumaantal dat als geheel getal kan worden geretourneerd.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de GetMaxCharCount methode gebruikt om het maximum aantal tekens te berekenen dat nodig is om een opgegeven aantal bytes te decoderen.
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
Opmerkingen
De GetCharCount methode berekent de exacte matrixgrootte die door de GetChars methode is vereist om de resulterende tekens op te slaan, terwijl de GetMaxCharCount methode de maximale matrixgrootte berekent. De GetCharCount methode wijst doorgaans minder geheugen toe, terwijl de GetMaxCharCount methode over het algemeen sneller wordt uitgevoerd.
GetMaxCharCount haalt een slechtst getal op, inclusief het slechtste geval voor de geselecteerde DecoderFallback. Als er een terugval van een decoder aanwezig is met een maximale terugvallengte van n, retourneert de GetMaxCharCount methode n * byteCount.
GetMaxCharCount heeft geen relatie tot GetBytes. Als uw toepassing een vergelijkbare functie nodig heeft om mee GetByteste gebruiken, moet deze worden gebruikt GetMaxByteCount.
Note
GetMaxCharCount(N) is niet noodzakelijkerwijs dezelfde waarde als N* GetMaxCharCount(1).