Application.ReplaceEx-Methode (Project)

Artikel
10/17/2024

Sucht nach einem ungefilterten Wert in einem angegebenen Feld oder in allen verfügbaren Feldern und ersetzt ihn durch den angegebenen Wert.

Syntax

Ausdruck. ReplaceEx (Field, Test, Value, Replacement, ReplaceAll, Next, MatchCase, FieldID, TestID, SearchAllFields)

Ausdruck Ein Ausdruck, der ein Application-Objekt zurückgibt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Feld	Optional	String	Der Name des zu suchenden Felds.
Test	Optional	String	Der Typ des Vergleichs zwischen Field und Value. Dies kann eine der Vergleichszeichenfolgen sein.
Wert	Optional	Variant	Der Wert, der mit dem Wert des in Feld angegebenen Felds verglichen werden soll.
Replacement	Optional	Variant	Verwenden Sie "" (eine leere Zeichenfolge), um Field an der Stelle zu löschen, an der es den durch Test und Wert angegebenen Test erfüllt.
ReplaceAll	Optional	Variant	True, Wenn alle Vorkommen von Value ersetzt werden. False, Wenn nur das erste Vorkommen ersetzt wird. Der Standardwert ist False.
Next	Optional	Variant	True, wenn Project nach unten nach der nächsten Übereinstimmung mit den Suchkriterien sucht. False, Wenn das Projekt für das nächste Vorkommen sucht. Der Standardwert ist True.
MatchCase	Optional	Variant	True, Wenn die Suche Groß-/Kleinschreibung beachtet wird. Der Standardwert ist False.
FieldID	Optional	Variant	Die Feldidentifikationsnummer kann eine der PjField-Konstanten sein. FieldID hat Vorrang gegenüber jedem Field-Wert.
TestID	Optional	Variant	Die Testidentifikationsnummer kann eine der PjComparison-Konstanten sein. TestID hat Vorrang gegenüber jedem Test-Wert.
SearchAllFields	Optional	Variant	Bei True ersetzen Sie den angegebenen Wert in allen verfügbaren Feldern. Der Standardwert ist False. SearchAllFields hat Vorrang vor Field und FieldID.

Vergleichszeichenfolgen

Vergleichszeichenfolge	Beschreibung
"Gleich"	Der Wert von Field ist gleich Value.
"Ungleich"	Der Wert von Field ist ungleich Value.
"Größer als"	Der Wert von Field ist größer als Value.
"Größer oder gleich"	Der Wert von Field ist größer oder gleich Value.
"Kleiner als"	Der Wert von Field ist kleiner als Value.
"Kleiner oder gleich"	Der Wert von Field ist kleiner oder gleich Value.
"Innerhalb"	Der Wert von Field ist innerhalb von Value.
"Nicht innerhalb"	Der Wert von Field ist nicht innerhalb von Value.
"Enthält"	Feld enthält Wert.
"Enthält nicht"	Feld enthält nicht Value.
"Enthält genau"	Das Feld enthält genau Value.

Rückgabewert

Boolean

True, wenn eine Ersetzung vorgenommen werden; andernfalls False.

Hinweise

Wenn Sie die ReplaceEx-Methode ohne Argumente oder ohne Angabe von Field, Test und Value verwenden, wird das Dialogfeld Ersetzen angezeigt, in dem Optionen für den vorherigen Zustand festgelegt sind. Wenn Sie SearchAllFields auf True festlegen, sind für die programmgesteuerte Verwendung weiterhin Werte für die Parameter Field, Test und Value erforderlich.

Beispiel

Beide Zeilen im folgenden Beispiel ersetzen in der Menge der verfügbaren Felder "Bad" durch "Good".

Sub Bad2Good() 
    ReplaceEx Field:="Name", Test:="contains", Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
    ReplaceEx Field:="xx", Test:="xx", TestID:=pjCompareContains, Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über