Replace, fonction (Visual Basic)

  • Article

Mise à jour : novembre 2007

Retourne une chaîne dans laquelle une sous-chaîne spécifiée a été remplacée par une autre sous-chaîne, un nombre de fois déterminé.

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

Paramètres

  • Expression
    Requis. Expression de chaîne contenant la sous-chaîne à remplacer.

  • Find
    Requis. Sous-chaîne à rechercher.

  • Replacement
    Requis. Sous-chaîne de remplacement.

  • Start
    Facultatif. Position dans Expression où la recherche de la sous-chaîne doit commencer. Si cet argument est omis, la position 1 est utilisée par défaut.

  • Count
    Facultatif. Nombre de remplacements de la sous-chaîne à effectuer. Si cet argument est omis, la valeur par défaut est –1, ce qui implique l'exécution de tous les remplacements possibles.

  • Compare
    Facultatif. Valeur numérique indiquant le type de comparaison à utiliser pour l'évaluation des sous-chaînes. Consultez la section Valeurs pour obtenir les valeurs.

Paramètres

L'argument Compare peut prendre les valeurs suivantes.

Constante

Description

Binary

Effectue une comparaison binaire.

Text

Effectue une comparaison de texte.

Valeur de retour

Replace retourne les valeurs suivantes.

Si

Valeur retournée par la fonction Replace

Find est de longueur nulle ou Nothing

Copie de Expression

Replace est de longueur nulle

Copie de Expression sans occurrence de Find

Expression est de longueur nulle ou Nothing, ou Start est supérieur à la longueur de Expression

Nothing

L'argument Count a la valeur 0

Copie de Expression

Exceptions

Type d'exception

Numéro de l'erreur

Condition

ArgumentException

5

Count < -1 ou Start <= 0.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La valeur de retour de la fonction Replace est une chaîne qui commence à la position spécifiée par Start et qui se termine à la fin de la chaîne Expression, dont les substitutions sont effectuées comme spécifié par les valeurs Find et Replace.

Exemple

Cet exemple illustre la fonction Replace.

Dim TestString As String = "Shopping List"
' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**Strings

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Référence

Liste des manipulations de chaînes

Filter, fonction (Visual Basic)

ArgumentException