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

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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. Expression String à convertir.

Conversion: VbStrConv

Obligatoire. Membre VbStrConv. Valeur d'énumération qui spécifie le type de conversion à effectuer.

LocaleID: Int32

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

Retours

String

Une chaîne convertie comme spécifié.

Attributs: SupportedOSPlatformAttribute

Exceptions

ArgumentException

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

Exemples

Cet exemple montre comment convertir du 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.TraditionalChineseVbStrConv.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 sur lequel le module linguistique japonais est 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 changements de cas soient appropriés pour les paramètres régionaux dans lesquels l’application est utilisée.

Important

Si votre application prend des décisions de sécurité basées sur le résultat d’une comparaison ou d’une opération de changement 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 en Visual Basic.

Les paramètres de l’argument Conversion sont :

Membre d’énumération	Description
`VbStrConv.None`	N’effectue aucune conversion
`VbStrConv.LinguisticCasing`	Utilise des règles linguistiques pour la casse, plutôt que le système de fichiers (par défaut). Valide avec `VbStrConv.UpperCase` et `VbStrConv.LowerCase` uniquement.
`VbStrConv.UpperCase`	Convertit la chaîne spécifiée en majuscules.
`VbStrConv.LowerCase`	Convertit la chaîne spécifiée en 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) de la chaîne en caractères larges (pleine largeur). La conversion peut utiliser la forme de normalisation C même si un caractère d’entrée est déjà en pleine chasse. Par exemple, la chaîne « は゛ » (qui est déjà en pleine chasse) est normalisée en « ば ». Consultez Unicode normalization forms.
`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 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.

Notes

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

Les séparateurs de mots valides pour la casse appropriée sont les suivants : Null (Chr$(0)), tabulation horizontale (Chr$(9)), saut de ligne (Chr$(10)), tabulation verticale (Chr$(11)), flux de formulaire (Chr$(12)), retour chariot (Chr$(13)), espace (jeu de caractères codés 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 de l’Asie de l’Est.

S’applique à