Partager via


NamedRange.Replace, méthode

Remplace les caractères spécifiés dans le contrôle NamedRange par une nouvelle chaîne.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function Replace ( _
    What As Object, _
    Replacement As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object, _
    ReplaceFormat As Object _
) As Boolean
bool Replace(
    Object What,
    Object Replacement,
    Object LookAt,
    Object SearchOrder,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat,
    Object ReplaceFormat
)

Paramètres

  • What
    Type : System.Object
    Chaîne que Microsoft Office Excel doit rechercher.
  • MatchCase
    Type : System.Object
    true si la recherche doit respecter la casse.
  • MatchByte
    Type : System.Object
    Vous pouvez utiliser uniquement cet argument si vous avez sélectionné ou installé la prise en charge linguistique de jeux de caractères codés sur deux octets dans Excel.true pour que les caractères codés sur deux octets correspondent uniquement à des caractères codés sur deux octets ; false pour que les caractères codés sur deux octets correspondent aux caractères codés sur un octet équivalents.
  • SearchFormat
    Type : System.Object
    Format de recherche de la méthode.
  • ReplaceFormat
    Type : System.Object
    Format de remplacement de la méthode.

Valeur de retour

Type : System.Boolean
true si les caractères spécifiés figurent dans les cellules du contrôle NamedRange ; sinon, false.

Notes

L'utilisation de cette méthode n'affecte pas la sélection ou la cellule active.

Les paramètres de LookAt, SearchOrder, MatchCase et de MatchByte sont enregistrés chaque fois que vous utilisez cette méthode. Si vous ne spécifiez pas de valeurs pour ces arguments la prochaine fois que vous appelez la méthode, les valeurs enregistrées sont utilisées. La définition de ces arguments modifie les paramètres de la boîte de dialogue Recherche, et la modification des paramètres dans la boîte de dialogue Recherche modifie les valeurs enregistrées qui sont utilisées si vous omettez les arguments. Pour éviter tout problème, définissez explicitement ces arguments chaque fois que vous utilisez cette méthode.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant affecte la chaîne "This is a sentence." à la valeur des cellules du contrôle NamedRange, puis utilise la méthode Replace pour remplacer la sous-chaîne "a" par "my".

Cet exemple illustre une personnalisation au niveau du document.

    Private Sub ReplaceValue()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Value2 = "This is a sentence."
        namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart, _
            Excel.XlSearchOrder.xlByColumns, False, , , )
    End Sub

private void ReplaceValue()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    namedRange1.Value2 = "This is a sentence.";
    namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart,
        Excel.XlSearchOrder.xlByColumns, false);
}

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms