Strings.StrConv(String, VbStrConv, Int32) Metodo

Definizione

Restituisce una stringa convertita come specificato.

[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

Parametri

str
String

Obbligatorio. Espressione String da convertire.

Conversion
VbStrConv

Obbligatorio. Membro VbStrConv. Valore dell'enumerazione che specifica il tipo di conversione da eseguire.

LocaleID
Int32

facoltativo. Valore di LocaleID, se diverso dal valore di LocaleID del sistema. (Il valore predefinito è il valore di LocaleID del sistema.)

Restituisce

Stringa convertita come specificato.

Attributi

Eccezioni

Oggetto LocaleID non supportato, Conversion< 0 o > 2048 oppure conversione non supportata per le impostazioni locali specificate.

Esempio

In questo esempio il testo viene convertito in tutte le lettere minuscole.

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

Commenti

Le costanti , , VbStrConv.NarrowVbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakanae VbStrConv.Hiragana possono causare errori di runtime quando vengono usate nelle impostazioni locali in cui non si applicano, ma non sempre: le costanti VbStrConv.KatakanaVbStrConv.Widee VbStrConv.Hiragana possono essere usate in un sistema non giapponese con il Language Pack giapponese installato. Inoltre, l'uso delle costanti VbStrConv.Wide ed VbStrConv.Narrow è supportato in qualsiasi sistema con una lingua asiatica installata.

Questa funzione usa le informazioni sulle impostazioni cultura dell'applicazione durante la modifica della stringa in modo che le modifiche del case siano appropriate per le impostazioni locali in cui viene usata l'applicazione.

Importante

Se l'applicazione prende decisioni di sicurezza in base al risultato di un'operazione di confronto o di modifica del caso, l'operazione deve usare il String.Compare metodo e passare Ordinal o OrdinalIgnoreCase per l'argomento comparisonType . Per altre informazioni, vedere Impatto delle impostazioni cultura sulle stringhe in Visual Basic.

Le impostazioni dell'argomento Conversion sono le seguenti:

Membro di enumerazione Descrizione
VbStrConv.None Non esegue alcuna conversione
VbStrConv.LinguisticCasing Usa regole linguistiche per l'uso di maiuscole e minuscole, anziché file system (impostazione predefinita). Valido solo con VbStrConv.UpperCase e VbStrConv.LowerCase .
VbStrConv.UpperCase Converte la stringa in lettere maiuscole.
VbStrConv.LowerCase Converte la stringa specificata in lettere minuscole.
VbStrConv.ProperCase Converte la prima lettera di ogni parola in stringa in maiuscolo.
VbStrConv.Wide * Converte caratteri stretti (a metà larghezza) nella stringa in caratteri wide (a larghezza intera). La conversione può usare il formato di normalizzazione C anche se un carattere di input è già a larghezza intera. Ad esempio, la stringa "は゛" (che è già a larghezza intera) viene normalizzata in "ば". Vedere Unicode Normalization Forms (Formati di normalizzazione Unicode).
VbStrConv.Narrow * Converte caratteri wide (a larghezza intera) nella stringa in caratteri stretti (a metà larghezza).
VbStrConv.Katakana ** Converte i caratteri Hiragana della stringa in caratteri Katakana.
VbStrConv.Hiragana ** Converte i caratteri Katakana della stringa in caratteri Hiragana.
VbStrConv.SimplifiedChinese * Converte i caratteri cinesi tradizionali in cinese semplificato.
VbStrConv.TraditionalChinese * Converte i caratteri cinesi semplificati in cinese tradizionale.

* Si applica alle impostazioni locali asiatiche.

** Si applica solo al Giappone.

Nota

Queste costanti vengono specificate in Common Language Runtime di .NET Framework. Di conseguenza, possono essere usati in qualsiasi punto del codice al posto dei valori effettivi. La maggior parte può essere combinata (ad esempio, UpperCase + Wide), tranne quando si escludono a vicenda (ad esempio, VbStrConv.Wide + VbStrConv.Narrow).

Di seguito sono riportati i separatori di parole validi per le maiuscole e minuscole appropriate: Null (Chr$(0)), tabulazione orizzontale (Chr$(9)), avanzamento riga (Chr$(10)), tabulazione verticale (Chr$(11)), avanzamento modulo (), ritorno a capo (Chr$(12)Chr$(13)), spazio (set di caratteri a byte singolo) (Chr$(32)). Il valore effettivo per uno spazio, che può essere pieno o mezzo, varia in base al paese o all'area geografica per le impostazioni cultura dell'Asia orientale.

Si applica a

Vedi anche