ASCIIEncoding.GetMaxByteCount(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 bytes dat wordt geproduceerd door het opgegeven aantal tekens te coderen.
public:
override int GetMaxByteCount(int charCount);public override int GetMaxByteCount(int charCount);override this.GetMaxByteCount : int -> intPublic Overrides Function GetMaxByteCount (charCount As Integer) As IntegerParameters
- charCount
- Int32
Het aantal tekens dat moet worden gecodeerd.
Retouren
Het maximum aantal bytes dat wordt geproduceerd door het opgegeven aantal tekens te coderen.
Uitzonderingen
charCount 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 GetMaxByteCount methode gebruikt om de bytes te berekenen die nodig zijn om een opgegeven aantal tekens te coderen.
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
ASCIIEncoding ascii = new ASCIIEncoding();
int charCount = 2;
int maxByteCount = ascii.GetMaxByteCount(charCount);
Console.WriteLine(
"Maximum of {0} bytes needed to encode {1} characters.",
maxByteCount,
charCount
);
}
}
Imports System.Text
Class ASCIIEncodingExample
Public Shared Sub Main()
Dim ascii As New ASCIIEncoding()
Dim charCount As Integer = 2
Dim maxByteCount As Integer = ascii.GetMaxByteCount(charCount)
Console.WriteLine( _
"Maximum of {0} bytes needed to encode {1} characters.", _
maxByteCount, _
charCount _
)
End Sub
End Class
Opmerkingen
De GetByteCount methode berekent de exacte matrixgrootte die door de GetBytes methode is vereist voor het opslaan van de resulterende bytes, terwijl de GetMaxByteCount methode de maximale matrixgrootte berekent. De GetByteCount methode wijst doorgaans minder geheugen toe, maar de GetMaxByteCount methode wordt doorgaans sneller uitgevoerd.
GetMaxByteCount is een slechtst getal, inclusief het slechtste geval voor de geselecteerde EncoderFallback. Als u een vervangende terugval kiest met een mogelijk grote tekenreeks, GetMaxByteCount kunnen grote waarden worden geretourneerd.
De GetMaxByteCount methode beschouwt mogelijke restover surrogaten van een eerdere coderingsbewerking. Als het ASCIIEncoding object de standaard vervangende terugval gebruikt of als er een aangepaste vervangingsval is gedefinieerd met één mogelijk terugvalteken, retourneert charCount de methode + 1. Als het ASCIIEncoding object een vervangende terugval met meer dan één mogelijk terugvalteken gebruikt, retourneert de methode n * (charCount + 1), waarbij n het maximum aantal terugvaltekens is.
GetMaxByteCount heeft geen relatie tot GetChars. Als uw toepassing een vergelijkbare functie nodig heeft om mee GetCharste gebruiken, moet deze worden gebruikt GetMaxCharCount.
Note
GetMaxByteCount(N) is niet noodzakelijkerwijs dezelfde waarde als N* GetMaxByteCount(1).