UTF8Encoding.GetMaxCharCount(Int32) Methode

Definitie

Naamruimte:
System.Text
Assembly's:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
netstandard.dll

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 -> int
Public Overrides Function GetMaxCharCount (byteCount As Integer) As Integer

Parameters

byteCount
Int32

Het aantal bytes dat moet worden gedecodeerd.

Retouren

Int32

Het maximum aantal tekens dat wordt geproduceerd door het opgegeven aantal bytes te decoderen.

Uitzonderingen

ArgumentOutOfRangeException

byteCount is kleiner dan nul.

– of –

Het resulterende aantal bytes is groter dan het maximumaantal dat als geheel getal kan worden geretourneerd.

DecoderFallbackException

Er is een terugval opgetreden (zie Character Encoding in .NET)

en

DecoderFallback is ingesteld op DecoderExceptionFallback.

Voorbeelden

In het volgende voorbeeld wordt de GetMaxCharCount methode gebruikt om het maximum aantal tekens te retourneren dat wordt geproduceerd door het decoderen van een opgegeven aantal bytes.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int byteCount = 8;
        int maxCharCount = utf8.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = utf8.GetMaxCharCount(byteCount)
        Console.WriteLine( _
            "Maximum of {0} characters needed to decode {1} bytes.", _
            maxCharCount, _
            byteCount _
        )
    End Sub
End Class

Opmerkingen

Als u de exacte matrixgrootte wilt berekenen die is vereist voor GetChars het opslaan van de resulterende tekens, roept u de GetCharCount methode aan. Als u de maximale matrixgrootte wilt berekenen, roept u de GetMaxCharCount methode aan. De GetCharCount methode wijst doorgaans minder geheugen toe, terwijl de GetMaxCharCount methode over het algemeen sneller wordt uitgevoerd.

GetMaxCharCount is een slechtst getal, inclusief het slechtste geval voor de geselecteerde DecoderFallback. Als een terugval is gekozen met een mogelijk grote tekenreeks, GetMaxCharCount kunnen grote waarden worden geretourneerd.

In de meeste gevallen retourneert deze methode redelijke getallen voor kleine tekenreeksen. Voor grote tekenreeksen moet u mogelijk kiezen tussen het gebruik van zeer grote buffers en het ondervangen van fouten in het zeldzame geval dat een meer redelijke buffer wordt overschreden. U kunt ook een andere benadering overwegen met behulp van GetCharCount of Encoder.Convert.

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).

Van toepassing op

Zie ook