ASCIIEncoding.GetByteCount Méthode

Définition

Espace de noms:

System.Text

Assembly:

mscorlib.dll

Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères.

Surcharges

Nom	Description
GetByteCount(String)	Calcule le nombre d’octets générés par l’encodage des caractères dans le fichier spécifié String.
GetByteCount(Char*, Int32)	Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères commençant par le pointeur de caractère spécifié.
GetByteCount(Char[], Int32, Int32)	Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères à partir du tableau de caractères spécifié.

GetByteCount(String)

Calcule le nombre d’octets générés par l’encodage des caractères dans le fichier spécifié String.

public:
 override int GetByteCount(System::String ^ chars);

public override int GetByteCount(string chars);

override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (chars As String) As Integer

Paramètres

chars

String

Contenant String le jeu de caractères à encoder.

Retours

Int32

Nombre d’octets produits par encodage des caractères spécifiés.

Exceptions

ArgumentNullException

chars a la valeur null.

ArgumentOutOfRangeException

Le nombre d’octets obtenu est supérieur au nombre maximal qui peut être retourné sous forme d’entier.

EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET)

-et-

EncoderFallback a la valeur EncoderExceptionFallback.

Exemples

L’exemple suivant montre comment utiliser la GetByteCount méthode pour retourner le nombre d’octets requis pour encoder une chaîne à l’aide ASCIIEncodingde .

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        String chars = "ASCII Encoding Example";

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars);
        Console.WriteLine(
            "{0} bytes needed to encode string.", byteCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars)
        Console.WriteLine("{0} bytes needed to encode string.", byteCount)
    End Sub
End Class

Remarques

Pour calculer la taille exacte du tableau requise pour GetBytes stocker les octets résultants, l’application utilise GetByteCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxByteCount. La GetByteCount méthode autorise généralement l’allocation de moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Voir aussi

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()
• Présentation des encodages

GetByteCount(Char*, Int32)

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS

System.Text.ASCIIEncoding.GetByteCount(Char[], Int32, Int32)

Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères commençant par le pointeur de caractère spécifié.

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount(char* chars, int count);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

Paramètres

chars

Char*

Pointeur vers le premier caractère à encoder.

count

Int32

Nombre de caractères à encoder.

Retours

Int32

Nombre d’octets produits par encodage des caractères spécifiés.

Attributs

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceptions

ArgumentNullException

chars a la valeur null.

ArgumentOutOfRangeException

count est inférieur à zéro.

-ou-

Le nombre d’octets obtenu est supérieur au nombre maximal qui peut être retourné sous forme d’entier.

EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET)

-et-

EncoderFallback a la valeur EncoderExceptionFallback.

Remarques

Pour calculer la taille exacte du tableau requise pour GetBytes stocker les octets résultants, l’application utilise GetByteCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxByteCount. La GetByteCount méthode autorise généralement l’allocation de moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Voir aussi

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()

GetByteCount(Char[], Int32, Int32)

Calcule le nombre d’octets générés par l’encodage d’un jeu de caractères à partir du tableau de caractères spécifié.

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);

public override int GetByteCount(char[] chars, int index, int count);

override this.GetByteCount : char[] * int * int -> int

Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Paramètres

chars

Char[]

Tableau de caractères contenant le jeu de caractères à encoder.

index

Int32

Index du premier caractère à encoder.

count

Int32

Nombre de caractères à encoder.

Retours

Int32

Nombre d’octets produits par encodage des caractères spécifiés.

Exceptions

ArgumentNullException

chars a la valeur null.

ArgumentOutOfRangeException

index ou count est inférieur à zéro.

-ou-

index et count ne désignent pas une plage valide en chars.

-ou-

Le nombre d’octets obtenu est supérieur au nombre maximal qui peut être retourné sous forme d’entier.

EncoderFallbackException

Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET)

-et-

EncoderFallback a la valeur EncoderExceptionFallback.

Exemples

L’exemple suivant montre comment utiliser la GetByteCount méthode pour retourner le nombre d’octets requis pour encoder un tableau de caractères Unicode à l’aide ASCIIEncodingde .

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Remarques

Pour calculer la taille exacte du tableau requise pour GetBytes stocker les octets résultants, l’application utilise GetByteCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxByteCount. La GetByteCount méthode autorise généralement l’allocation de moins de mémoire, tandis que la GetMaxByteCount méthode s’exécute généralement plus rapidement.

Voir aussi

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()