Strings.Chr, méthode

Retourne le caractère associé au code de caractère spécifié.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Chr ( _
    CharCode As Integer _
) As Char
'Utilisation
Dim CharCode As Integer
Dim returnValue As Char

returnValue = Strings.Chr(CharCode)

public static char Chr (
    int CharCode
)

public:
static wchar_t Chr (
    int CharCode
)

public static char Chr (
    int CharCode
)

public static function Chr (
    CharCode : int
) : char

Paramètres

• CharCode
  Obligatoire. Expression Integer représentant le point de code (ou code de caractère) du caractère. Si CharCode se trouve en dehors de la plage valide, une erreur ArgumentException se produit. La plage valide pour Chr s'étend de 0 à 255, et la plage valide pour ChrW s'étend de -32 768 à 65 535.

Valeur de retour

Retourne le caractère associé au code de caractère spécifié.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Fonctions Chr, ChrW.

La plage asymétrique autorisée pour CharCode compense les différences de stockage entre le types de données Short (Visual Basic) et le types de données Integer (Visual Basic). Par exemple, -29 183 est un Short, mais +36 353 est un Integer. Cela simplifie également la compatibilité avec Visual Basic 6.0.

Chr utilise la classe Encoding de l'espace de noms System.Text pour déterminer si le thread actuel utilise un jeu de caractères codés sur un octet (SBCS, Single-Byte Character Set) ou sur deux octets (DBCS, Double-Byte Character Set). Elle accepte ensuite CharCode comme point de code dans le jeu approprié. La plage peut s'étendre de 0 à 255 pour les caractères SBCS et de -32 768 à 65 535 pour les caractères DBCS. Pour les tableaux des caractères ASCII codés sur un octet, consultez Codes de caractères ASCII.

La valeur retournée dépend de la page de codes du thread actuel, 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.

ChrW accepte CharCode comme point de code Unicode. La plage est indépendante des paramètres de culture et de page de codes du thread actuel. Les valeurs comprises entre -32 768 et -1 sont traitées de la même façon que les valeurs comprises entre +32 768 et +65 535.

Les nombres de 0 à 31 sont identiques aux codes ASCII standard non imprimables. Par exemple, Chr(10) retourne un caractère de saut de ligne.

Notes

La fonction ChrB des versions antérieures de Visual Basic retourne un seul octet. Son rôle principal consiste à convertir des chaînes en applications utilisant le jeu de caractères codés sur deux octets (DBCS). Dans Visual Basic et le .NET Framework, toutes les chaînes sont en Unicode, et la fonction ChrB n'est plus prise en charge.

Exemple

L'exemple suivant utilise la fonction Chr pour retourner le caractère associé au code de caractère spécifié.

Dim associatedChar As Char
' Returns "A".
associatedChar = Chr(65)
' Returns "a".
associatedChar = Chr(97)
' Returns ">".
associatedChar = Chr(62)
' Returns "%".
associatedChar = Chr(37)

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
CultureInfo
ArgumentException

Autres ressources

Fonctions Chr, ChrW
Liste des manipulations de chaînes
Fonctions Asc, AscW
Str, fonction
Fonctions de conversion (Visual Basic)
Fonctions de conversion de types de données
Codes de caractères ASCII