Funzione StrConv

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce una stringa convertita come specificato.

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

Parametri

str
Obbligatorio. L'espressione String da convertire.
Conversion
Obbligatorio. Il membro Enumerazione VbStrConv. Il valore di enumerazione che specifica il tipo di conversione da eseguire.
LocaleID
Facoltativo. Il valore LocaleID, se diverso dal valore corrente delle impostazioni cultura dell'applicazione. Per ulteriori informazioni su ID delle impostazioni internazionali e sulle impostazioni cultura, vedere CultureInfo . Il valore corrente delle impostazioni cultura dell'applicazione è quello predefinito.

Impostazioni

Le possibili impostazioni dell'argomento Conversion sono:

Membro di enumerazione	Descrizione
VbStrConv.None	Nessuna conversione.
VbStrConv.LinguisticCasing	Vengono utilizzate regole linguistiche per la distinzione tra maiuscole e minuscole invece del file system (valore predefinito). È valido esclusivamente con VbStrConv.UpperCase e VbStrConv.LowerCase.
VbStrConv.UpperCase	I caratteri della stringa vengono convertiti in maiuscolo.
VbStrConv.LowerCase	I caratteri della stringa vengono convertiti in minuscolo.
VbStrConv.ProperCase	La prima lettera di ogni parola della stringa viene convertita in maiuscolo.
VbStrConv.Wide^*	I caratteri stretti (metà larghezza) della stringa vengono convertiti in caratteri larghi (a tutta larghezza).
VbStrConv.Narrow^*	I caratteri larghi (a tutta larghezza) della stringa vengono convertiti in caratteri stretti (metà larghezza).
VbStrConv.Katakana^**	I caratteri Hiragana della stringa vengono convertiti in caratteri Katakana.
VbStrConv.Hiragana^**	I caratteri Katakana della stringa vengono convertiti in caratteri Hiragana.
VbStrConv.SimplifiedChinese^*	I caratteri Cinese tradizionale vengono convertiti in Cinese semplificato.
VbStrConv.TraditionalChinese^*	I caratteri Cinese semplificato vengono convertiti in Cinese tradizionale.

^* Valido per le impostazioni internazionali dei paesi asiatici.

^** Valido solo per il Giappone.

Nota:
Queste costanti sono specificate in .NET Framework Common Language Runtime e possono essere utilizzate in qualsiasi punto del codice in sostituzione dei valori effettivi. La maggior parte di esse si presta a combinazioni, ad esempio UpperCase + Wide, a eccezione di quelle che si escludono a vicenda, ad esempio VbStrConv.Wide + VbStrConv.Narrow.

I separatori di parole indicati di seguito sono considerati validi per la conversione: Null (Chr$(0)), tabulazione orizzontale (Chr$(9)), avanzamento riga (Chr$(10)), tabulazione verticale (Chr$(11)), avanzamento modulo (Chr$(12)), ritorno a capo (Chr$(13)), spazio (set di caratteri a byte singolo) (Chr$(32)). Il valore effettivo per uno spazio, che può essere intero o ridotto, non è lo stesso in tutti i paesi delle culture dell'Asia orientale.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	LocaleID, Conversion < 0 o > 2048 non sono supportati oppure non è supportata la conversione per le impostazioni internazionali specificate.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Le costanti VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana e VbStrConv.Hiragana possono generare errori in fase di esecuzione, se utilizzate con impostazioni internazionali che non ne consentono l'applicazione, eccezion fatta per le costanti VbStrConv.Katakana e VbStrConv.Hiragana che possono essere utilizzate in sistemi diversi da quello giapponese a condizione che sia installato il Language Pack per il giapponese. Anche l'utilizzo delle costanti VbStrConv.Wide e VbStrConv.Narrow è supportato in tutti i sistemi nei quali sia installata una lingua dell'Asia orientale.

Questa funzione utilizza le informazioni relative alle impostazioni cultura dell'applicazione durante la modifica della stringa per inserire le maiuscole e le minuscole in modo appropriato a seconda delle impostazioni internazionali con le quali viene utilizzata l'applicazione.

Nota sulla sicurezza:
Se l'applicazione prende decisioni di protezione in base al risultato di un confronto o un'operazione basata sul risultato di una modifica, l'operazione dovrebbe utilizzare il metodo String.Compare e passare Ordinal o OrdinalIgnoreCase per l'argomento comparisonType. Per ulteriori informazioni, vedere Influenza delle impostazioni cultura sulle stringhe in Visual Basic.

Esempio

Nell'esempio seguente il testo viene interamente convertito in lettere minuscole:

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

Note per gli sviluppatori di applicazioni per Smart Device

Questa funzione non è supportata.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic

**Modulo:**Strings

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Riferimenti

Riepilogo della gestione delle stringhe

Funzioni Chr e ChrW

Tipo di dati String (Visual Basic)

Funzioni di conversione del tipo

ArgumentException

Share via