Partager via


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

Définition

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? StrConv (string? str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
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

Obligatoire. String expression à convertir.

Conversion
VbStrConv

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

LocaleID
Int32

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

Retours

Chaîne convertie comme spécifié.

Attributs

Exceptions

LocaleIDnon pris en charge, Conversion< 0 ou > 2048 ou conversion 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.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakanaet 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 méthode String.Compare et passer Ordinal ou OrdinalIgnoreCase pour l’argument comparisonType. Pour plus d’informations, consultez Comment la culture affecte les chaînes dans Visual Basic.

Les paramètres d’argument Conversion 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 uniquement avec VbStrConv.UpperCase et VbStrConv.LowerCase.
VbStrConv.UpperCase Convertit la chaîne en caractères majuscules.
VbStrConv.LowerCase Convertit la chaîne en caractères minuscules.
VbStrConv.ProperCase Convertit la première lettre de chaque mot en 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 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 (Chr$(9)), flux de ligne (Chr$(10)), tabulation verticale (Chr$(11)), flux de formulaire (Chr$(12)), retour chariot (Chr$(13)), espace (jeu de caractères à 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