ASCIIEncoding.GetMaxByteCount(Int32) Méthode

public:
 override int GetMaxByteCount(int charCount);

public override int GetMaxByteCount(int charCount);

override this.GetMaxByteCount : int -> int

Public Overrides Function GetMaxByteCount (charCount As Integer) As Integer

Paramètres

Retours

Nombre maximal d’octets générés par encodage du nombre spécifié de caractères.

Exceptions

Exemples

L’exemple suivant montre comment utiliser la GetMaxByteCount méthode pour calculer les octets requis pour encoder un nombre spécifié de caractères.

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

Remarques

La GetByteCount méthode calcule la taille exacte du tableau requise par la GetBytes méthode pour stocker les octets résultants, tandis que la GetMaxByteCount méthode calcule la taille maximale du tableau. La GetByteCount méthode alloue généralement moins de mémoire, mais la GetMaxByteCount méthode s’exécute généralement plus rapidement.

GetMaxByteCount est un nombre de pires cas, y compris le pire cas pour le moment sélectionné EncoderFallback. Si vous choisissez un secours de remplacement avec une chaîne potentiellement volumineuse, GetMaxByteCount vous pouvez retourner des valeurs volumineuses.

La GetMaxByteCount méthode prend en compte les substitutions de substitution restantes potentielles d’une opération d’encodage précédente. Par conséquent, si l’objet ASCIIEncoding utilise le secours de remplacement par défaut ou si un secours de remplacement personnalisé a été défini avec un seul caractère de secours possible, la méthode retourne charCount + 1. Si l’objet ASCIIEncoding utilise une secours de remplacement avec plusieurs caractères de secours possibles, la méthode retourne n * (charCount + 1), où n correspond au nombre maximal de caractères de secours.

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

Voir aussi

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetEncoder()