XmlMappedRange.Replace-Methode

Artikel
08/10/2011

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.

Replacement
Typ: System.Object
Die Ersatzzeichenfolge.

LookAt
Typ: System.Object
Kann eine der folgenden XlLookAt-Konstanten sein: xlWhole oder xlPart.

SearchOrder
Typ: System.Object
Kann eine der folgenden XlSearchOrder-Konstanten sein: xlByRows oder xlByColumns.

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", missing,
        missing, missing, missing, missing, missing);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über