StrConv, fonction

Mise à jour : novembre 2007

Retourne une chaîne convertie comme spécifié.

Public Shared Function StrConv( _
   ByVal str As String, _
   ByVal Conversion As Microsoft.VisualBasic.VbStrConv, _
   Optional ByVal LocaleID As Integer, 
) As String

Paramètres

  • str
    Requis. Expression String à convertir.

  • Conversion
    Requis. Membre VbStrConv, énumération. Valeur d'énumération spécifiant le type de conversion à effectuer.

  • LocaleID
    Facultatif. Valeur LocaleID, si différente de la valeur de la culture en cours de l'application. Pour plus d'informations sur les ID de paramètres régionaux et les informations de culture, consultez CultureInfo. (La valeur de la culture en cours de l'application est la valeur par défaut.)

Paramètres

L'argument Conversion peut prendre les valeurs suivantes :

Membre de l'énumération

Description

VbStrConv.None

N'effectue pas de conversion.

VbStrConv.LinguisticCasing

Utilise les règles linguistiques pour la casse au lieu du système de fichiers (par défaut). Valide seulement avec VbStrConv.UpperCase et VbStrConv.LowerCase.

VbStrConv.UpperCase

Convertit la chaîne en majuscules.

VbStrConv.LowerCase

Convertit la chaîne en minuscules.

VbStrConv.ProperCase

Convertit en majuscule la première lettre de chaque mot d'une chaîne.

VbStrConv.Wide*

Convertit les caractères étroits (demi-largeur) de la chaîne en caractères larges (pleine largeur).

VbStrConv.Narrow*

Convertit les caractères larges (pleine largeur) de la chaîne en caractères étroits (demi-largeur).

VbStrConv.Katakana**

Convertit les caractères Hiragana de la chaîne en caractères Katakana.

VbStrConv.Hiragana**

Convertit les caractères Katakana de la chaîne en caractères Hiragana.

VbStrConv.SimplifiedChinese*

Convertit les caractères chinois traditionnels en chinois simplifié.

VbStrConv.TraditionalChinese*

Convertit les caractères chinois simplifiés en chinois traditionnels.

*   S'applique aux paramètres régionaux asiatiques.

**   Ne s'applique qu'au Japon.

Remarque :

Ces constantes sont spécifiées dans le Common Language Runtime du .NET Framework. En conséquence, elles peuvent être utilisées n'importe où dans votre code à la place des valeurs réelles. La plupart peuvent être combinées (par exemple, UpperCase + Wide), sauf lorsqu'elles s'excluent mutuellement (par exemple, VbStrConv.Wide + VbStrConv.Narrow).

Les séparateurs de mot valides pour la casse adéquate sont les suivants : Null (Chr$(0)), tabulation horizontale (Chr$(9)), saut de ligne (Chr$(10)), tabulation verticale (Chr$(11)), saut de page (Chr$(12)), retour chariot (Chr$(13)), espace (jeu de caractères codés sur un octet) (Chr$(32)). La valeur réelle pour un espace, qui peut être à demi-chasse/pleine chasse, varie en fonction du pays/de la région pour les cultures de l'est de l'Asie.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

ArgumentException

5

LocaleID n'est pas pris en charge, Conversion est inférieur à 0 ou supérieur à 2 048, ou la conversion n'est pas prise en charge pour les paramètres régionaux spécifiés.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (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'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Les constantes VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakanaet VbStrConv.Hiragana peuvent générer des erreurs d'exécution lorsqu'elles sont utilisées dans des paramètres régionaux où elles ne s'appliquent pas, mais pas toujours : les constantes VbStrConv.Katakana et VbStrConv.Hiragana peuvent être utilisées dans un système non japonais sur lequel le module linguistique japonais est installé. En outre, l'utilisation des constantes VbStrConv.Wide et VbStrConv.Narrow est prise en charge sur tout système sur lequel une langue de l'est de l'Asie est installée.

Cette fonction utilise les informations relatives à la culture de l'application lors de la manipulation de la chaîne afin que les changements de casse soient appropriés pour les paramètres régionaux dans lesquels l'application est utilisée.

Note de sécurité :

Si votre application prend des décisions relatives à la sécurité en fonction du résultat d'une comparaison ou d'une opération de modification des majuscules et des minuscules, l'opération doit utiliser la méthode String.Compare et passer Ordinal ou OrdinalIgnoreCase pour l'argument comparisonType. Pour plus d'informations, consultez Comment les informations de culture affectent les chaînes dans Visual Basic.

Exemple

L'exemple suivant convertit entièrement le texte en lettres minuscules.

Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)

Notes du développeur sur Smart Device

Cette fonction n'est pas prise en charge.

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**Strings

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Référence

Liste des manipulations de chaînes

Fonctions Chr, ChrW

String, type de données (Visual Basic)

Fonctions de conversion de types de données

ArgumentException