XmlMappedRange.Replace-Methode

  • Artikel

Ersetzt die angegebenen Zeichen im XmlMappedRange-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 dem XmlMappedRange-Steuerelement 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 in einem XmlMappedRange mithilfe der Replace-Methode die Zeichenfolge "Smith" durch die Zeichenfolge "Jones" ersetzt.In diesem Codebeispiel wird davon ausgegangen, dass das aktuelle Arbeitsblatt einen XmlMappedRange mit dem Namen CustomerLastNameCell enthält.

Private Sub ReplaceSmith()
    Me.CustomerLastNameCell.Value2 = "Walker, Smith, James"
    Me.CustomerLastNameCell.Replace("Smith", "Jones")
End Sub

private void ReplaceSmith()
{
    this.CustomerLastNameCell.Value2 = "Walker, Smith, James";
    this.CustomerLastNameCell.Replace("Smith", "Jones");
}

.NET Framework-Sicherheit

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace