ASCIIEncoding.GetMaxCharCount(Int32) Méthode

  • Référence

Définition

Espace de noms:
System.Text
Assemblys:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Calcule le nombre maximal de caractères produits par le décodage du nombre d'octets spécifié.

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

Paramètres

byteCount
Int32

Nombre d'octets à décoder.

Retours

Int32

Nombre maximal de caractères produits par le décodage du nombre d'octets spécifié.

Exceptions

ArgumentOutOfRangeException

byteCount est inférieur à zéro.

  • ou - Le nombre d’octets résultant est supérieur au nombre maximal accepté pour un entier.

Exemples

L’exemple suivant montre comment utiliser la GetMaxCharCount méthode pour calculer le nombre maximal de caractères nécessaires pour décoder un nombre spécifié d’octets.

using namespace System;
using namespace System::Text;
int main()
{
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = 8;
   int maxCharCount = ascii->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

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

Remarques

La GetCharCount méthode calcule la taille exacte du tableau requise par la GetChars méthode pour stocker les caractères résultants, tandis que la GetMaxCharCount méthode calcule la taille maximale du tableau. La GetCharCount méthode alloue généralement moins de mémoire, tandis que la GetMaxCharCount méthode s’exécute généralement plus rapidement.

GetMaxCharCountRécupère un nombre de cas le plus défavorable, y compris le pire cas pour le actuellement sélectionné DecoderFallback . Si un secours de décodeur est présent qui a une longueur de secours maximale de n, la GetMaxCharCount méthode retourne n * byteCount.

GetMaxCharCountn’a aucune relation avec GetBytes . Si votre application a besoin d’une fonction similaire à utiliser avec GetBytes, elle doit utiliser GetMaxByteCount.

Notes

GetMaxCharCount(N)n’est pas nécessairement la même valeur que N* GetMaxCharCount(1) .

S’applique à

Voir aussi