Funzione Replace (Visual Basic)

  • Articolo

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

ArgumentException

5

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

Funzione Filter (Visual Basic)

ArgumentException