Funzione Replace (Visual Basic)
Aggiornamento: novembre 2007
Restituisce una stringa nella quale la sottostringa specificata è stata sostituita con un'altra sottostringa per il numero di volte indicato.
Public Function Replace(
ByVal Expression As String,
ByVal Find As String,
ByVal Replacement As String,
Optional ByVal Start As Integer = 1,
Optional ByVal Count As Integer = -1,
Optional ByVal Compare As CompareMethod = CompareMethod.Binary
) As String
Parametri
Expression
Obbligatorio. Espressione stringa contenente la sottostringa da sostituire.Find
Obbligatorio. Sottostringa da cercare.Replacement
Obbligatorio. Sottostringa sostitutiva.Start
Facoltativo. Posizione in Expression dalla quale inizia la ricerca della sottostringa. Se il parametro viene omesso, verrà utilizzato il valore 1.Count
Facoltativo. Numero di sostituzioni di sottostringa da eseguire. Se omesso, verrà utilizzato il valore predefinito -1, ossia verranno eseguite tutte le sostituzioni possibili.Compare
Facoltativo. Valore numerico che indica il tipo di confronto da utilizzare nella valutazione delle sottostringhe. I possibili valori sono indicati nella sezione "Impostazioni".
Impostazioni
Di seguito sono indicati i possibili valori dell'argomento Compare.
Costante |
Descrizione |
---|---|
Binary |
Verrà eseguito un confronto binario. |
Text |
Verrà eseguito un confronto testuale. |
Valore restituito
La funzione Replace restituisce i valori riportati di seguito.
Se |
Replace restituirà |
---|---|
Find è di lunghezza zero o Nothing |
Copia di Expression |
Replace è di lunghezza zero |
Copia di Expression senza occorrenze di Find |
Expression è di lunghezza zero o Nothing oppure Start è di lunghezza maggiore rispetto a Expression |
Nothing |
Count è 0 |
Copia di Expression |
Eccezioni
Tipo di eccezione |
Numero di errore |
Condizione |
---|---|---|
Count < -1 o Start <= 0. |
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
Il valore restituito dalla funzione Replace è una stringa che inizia in corrispondenza della posizione specificata da Start e termina alla fine della stringa Expression, comprendente le sostituzioni eseguite in base ai valori specificati da Find e Replace.
Esempio
Nell'esempio riportato di seguito viene illustrato l'utilizzo della funzione Replace.
Dim TestString As String = "Shopping List"
' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")
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