Freigeben über


NamedRange.Replace-Methode

Ersetzt die angegebenen Zeichen im NamedRange-Steuerelement durch eine neue Zeichenfolge.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
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
)

Parameter

  • What
    Typ: System.Object
    Die Zeichenfolge, die Microsoft Office Excel für Sie suchen soll.
  • MatchCase
    Typ: System.Object
    true , um bei der Suche Groß- und Kleinschreibung zu unterscheiden.
  • MatchByte
    Typ: System.Object
    Sie können dieses Argument nur verwenden, wenn Sie die Unterstützung für Doppelbytezeichen in Excel ausgewählt oder installiert haben. true , wenn Doppelbytezeichen nur Doppelbytezeichen entsprechen sollen. false, wenn eine Übereinstimmung der Doppelbytezeichen mit ihren entsprechenden Einzelbytezeichen zulässig ist.
  • SearchFormat
    Typ: System.Object
    Das Suchformat für die Methode.
  • ReplaceFormat
    Typ: System.Object
    Das Ersetzungsformat für die Methode.

Rückgabewert

Typ: System.Boolean
true , wenn sich die angegebenen Zeichen in Zellen innerhalb des NamedRange-Steuerelements befinden; andernfalls false.

Hinweise

Mit dieser Methode ändert sich weder die Auswahl noch die aktive Zelle.

Die Einstellungen für LookAt, SearchOrder, MatchCase und MatchByte werden bei jeder Verwendung dieser Methode gespeichert.Wenn Sie für diese Argumente keine Werte angeben, werden beim nächsten Aufrufen der Methode die gespeicherten Werte verwendet.Durch das Festlegen dieser Argumente werden die Einstellungen im Dialogfeld Suchen geändert. Durch das Ändern der Einstellungen im Dialogfeld Suchen werden die gespeicherten Werte verändert, die verwendet werden, wenn Sie die Argumente weglassen.Zur Vermeidung dieser Probleme sollten Sie diese Argumente jedes Mal explizit festlegen, wenn Sie diese Methode verwenden.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird der Wert der Zellen in einem NamedRange-Steuerelement auf die Zeichenfolge "This is a sentence." festgelegt. Anschließend wird mithilfe der Replace-Methode die untergeordnete Zeichenfolge "a" durch "my" ersetzt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace