Strings.StrConv(String, VbStrConv, Int32) Méthode

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

public static string StrConv(string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

Paramètres

str
String

Required. String expression à convertir.

Conversion
VbStrConv

Required. VbStrConv Membre. Valeur d’énumération spécifiant le type de conversion à effectuer.

LocaleID
Int32

Optional. Valeur LocaleID , si elle est différente de la valeur système LocaleID . (La valeur système LocaleID est la valeur par défaut.)

Retours

String

Chaîne convertie comme spécifié.

Exceptions

ArgumentException

Conversion non prise en charge LocaleID, Conversion< 0 ou > 2048 ou non prise en charge pour les paramètres régionaux spécifiés.

Exemples

Cet exemple convertit le texte en lettres minuscules.

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

Remarques

Les constantes VbStrConv.Wide, VbStrConv.NarrowVbStrConv.SimplifiedChineseVbStrConv.TraditionalChinese, VbStrConv.Katakana, et VbStrConv.Hiragana peuvent provoquer des erreurs d’exécution lorsqu’elles sont utilisées dans les 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 avec le module linguistique japonais installé. En outre, l’utilisation des constantes VbStrConv.Wide et VbStrConv.Narrow est prise en charge sur n’importe quel système avec une langue d’Asie de l’Est installée.

Cette fonction utilise les informations de culture de l’application lors de la manipulation de la chaîne afin que les modifications de cas soient appropriées pour les paramètres régionaux dans lesquels l’application est utilisée.

Important

Si votre application prend des décisions de sécurité en fonction du résultat d’une opération de comparaison ou de modification de cas, l’opération doit utiliser la String.Compare méthode et passer Ordinal ou OrdinalIgnoreCase pour l’argument comparisonType . Pour plus d’informations, consultez How Culture Affects Strings in Visual Basic.

Les Conversion paramètres d’argument sont les suivants :

Membre d’énumération Description
VbStrConv.None Effectue aucune conversion
VbStrConv.LinguisticCasing Utilise des règles linguistiques pour la casse, plutôt que pour le système de fichiers (par défaut). Valide avec VbStrConv.UpperCase et VbStrConv.LowerCase uniquement.
VbStrConv.UpperCase Convertit la chaîne en majuscules.
VbStrConv.LowerCase Convertit la chaîne en caractères minuscules.
VbStrConv.ProperCase Convertit la première lettre de chaque mot de chaîne en majuscules.
VbStrConv.Wide * Convertit les caractères étroits (demi-largeur) dans la chaîne en caractères larges (pleine largeur). La conversion peut utiliser le formulaire de normalisation C même si un caractère d’entrée est déjà en pleine largeur. Par exemple, la chaîne « は ゙ » (qui est déjà pleine largeur) est normalisée à « ば ». Consultez les formulaires de normalisation Unicode.
VbStrConv.Narrow * Convertit les caractères larges (pleine largeur) dans la chaîne en caractères étroits (demi-largeur).
VbStrConv.Katakana ** Convertit les caractères Hiragana dans la chaîne en caractères Katakana.
VbStrConv.Hiragana ** Convertit les caractères Katakana dans 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 traditionnel.

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

** S’applique uniquement au Japon.

Note

Ces constantes sont spécifiées dans le common language runtime .NET Framework. Par conséquent, 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).

Voici les séparateurs de mots valides pour la casse appropriée : Null (Chr$(0)), tabulation horizontale (), saut de ligne (Chr$(10)Chr$(9)), tabulation verticale (), flux de formulaire (Chr$(11)Chr$(12)), retour chariot (Chr$(13)), espace (jeu de caractères sur un octet) (Chr$(32)). La valeur réelle d’un espace, qui peut être pleine ou demi-largeur, varie selon le pays/la région pour les cultures d’Asie de l’Est.

S’applique à

Voir aussi