Fonctions Asc, AscW

Article
09/12/2008

Mise à jour : novembre 2007

Retourne une valeur de type Integer qui représente le code de caractère correspondant à un caractère.

Public Overloads Function Asc(ByVal String As Char) As Integer
Public Overloads Function AscW(ByVal String As Char) As Integer
' -or-
Public Overloads Function Asc(ByVal String As String) As Integer
Public Overloads Function AscW(ByVal String As String) As Integer

Paramètres

String
Requis. Toute expression Char ou String valide. Si String est une expression String, seul le premier caractère de la chaîne est utilisé pour l'entrée. Si String a la valeur Nothing ou ne contient aucun caractère, une erreur ArgumentException se produit.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	String est vide ou a une longueur nulle.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Asc retourne le point de code ou le code de caractère du caractère d'entrée. Il peut être compris entre 0 et 255 pour les valeurs du jeu de caractères codé sur un octet (SBCS) et entre -32 768 et 32 767 pour les valeurs du jeu de caractères codé sur deux octets (DBCS).

La valeur retournée dépend de la page de codes du thread en cours, contenue dans la propriété ANSICodePage de la classe TextInfo de l'espace de noms System.Globalization. Vous pouvez obtenir ANSICodePage en spécifiant System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

AscW retourne le point de code Unicode du caractère d'entrée. Il peut être compris entre 0 et 65 535. La valeur retournée est indépendante des paramètres de la culture et de la page de codes pour le thread en cours.

Remarque :
Dans les précédentes versions de Visual Basic, la fonction AscB retourne un code pour un octet, à la place d'un caractère. Son rôle est d'abord de convertir des chaînes en applications à jeu de caractères codés sur deux octets (DBCS, Double-Byte Character Set). Depuis Visual Basic 2005, les chaînes sont en Unicode et la fonction AscB n'est plus prise en charge.

Exemple

L'exemple suivant utilise la fonction Asc pour retourner des codes de caractère Integer, type de données (Visual Basic) correspondant à la première lettre de chaque chaîne.

Dim codeInt As Integer
' The following line of code sets codeInt to 65.
codeInt = Asc("A")
' The following line of code sets codeInt to 97.
codeInt = Asc("a")
' The following line of code sets codeInt to 65.
codeInt = Asc("Apple")