UTF7Encoding.GetCharCount Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Calcule le nombre de caractères produits par le décodage d'une séquence d'octets.
Surcharges
| GetCharCount(Byte[], Int32, Int32) |
Calcule le nombre de caractères produits par le décodage d'une séquence d'octets du tableau d'octets spécifié. |
| GetCharCount(Byte*, Int32) |
Calcule le nombre de caractères produits par le décodage d'une séquence d'octets commençant au pointeur d'octet spécifié. |
GetCharCount(Byte[], Int32, Int32)
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
Calcule le nombre de caractères produits par le décodage d'une séquence d'octets du tableau d'octets spécifié.
public:
override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);public override int GetCharCount (byte[] bytes, int index, int count);override this.GetCharCount : byte[] * int * int -> intPublic Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As IntegerParamètres
- bytes
- Byte[]
Tableau d'octets contenant la séquence d'octets à décoder.
- index
- Int32
Index du premier octet à décoder.
- count
- Int32
Nombre d'octets à décoder.
Retours
Nombre de caractères produits par le décodage de la séquence d'octets spécifiée.
Exceptions
bytes a la valeur null (Nothing).
index ou count est inférieur à zéro.
- ou -
index et count ne désignent pas une plage valide dans bytes.
- ou -
Le nombre de caractères résultant est supérieur au nombre maximal accepté pour un entier.
Un secours s’est produit (pour plus d’informations, consultez Codage de caractères dans .NET)
-et-
DecoderFallback a la valeur DecoderExceptionFallback.
Exemples
L’exemple de code suivant montre comment utiliser la GetCharCount méthode pour renvoyer le nombre de caractères générés par le décodage d’une plage d’éléments dans un tableau d’octets.
using namespace System;
using namespace System::Text;
int main()
{
array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
int charCount = Unicode->GetCharCount( bytes, 2, 8 );
Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}
using System;
using System.Text;
class UnicodeEncodingExample {
public static void Main() {
Byte[] bytes = new Byte[] {
85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
};
UnicodeEncoding Unicode = new UnicodeEncoding();
int charCount = Unicode.GetCharCount(bytes, 2, 8);
Console.WriteLine(
"{0} characters needed to decode bytes.", charCount
);
}
}
Imports System.Text
Class UnicodeEncodingExample
Public Shared Sub Main()
Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
Dim uni As New UnicodeEncoding()
Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
Console.WriteLine("{0} characters needed to decode bytes.", charCount)
End Sub
End Class
Remarques
Pour calculer la taille exacte du tableau requise par GetChars pour stocker les caractères résultants, utilisez GetCharCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxCharCount. La GetCharCount méthode permet généralement d’allouer moins de mémoire, tandis que la GetMaxCharCount méthode s’exécute généralement plus rapidement.
Voir aussi
S’applique à
GetCharCount(Byte*, Int32)
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
Important
Cette API n’est pas conforme CLS.
Calcule le nombre de caractères produits par le décodage d'une séquence d'octets commençant au pointeur d'octet spécifié.
public:
override int GetCharCount(System::Byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount (byte* bytes, int count);[System.CLSCompliant(false)]
public override int GetCharCount (byte* bytes, int count);[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> intParamètres
- bytes
- Byte*
Pointeur du premier octet à décoder.
- count
- Int32
Nombre d'octets à décoder.
Retours
Nombre de caractères produits par le décodage de la séquence d'octets spécifiée.
- Attributs
Exceptions
bytes a la valeur null (Nothing).
count est inférieur à zéro.
- ou -
Le nombre de caractères résultant est supérieur au nombre maximal accepté pour un entier.
Un secours s’est produit (pour plus d’informations, consultez Encodage de caractères dans .NET).
-et-
DecoderFallback a la valeur DecoderExceptionFallback.
Remarques
Pour calculer la taille exacte du tableau requise par GetChars pour stocker les caractères résultants, utilisez GetCharCount. Pour calculer la taille maximale du tableau, l’application doit utiliser GetMaxCharCount. La GetCharCount méthode permet généralement d’allouer moins de mémoire, tandis que la GetMaxCharCount méthode s’exécute généralement plus rapidement.
