FindReplaceOptions

FindReplaceOptions class

Gibt Optionen für Such-/Ersetzungsvorgänge an.

Um mehr zu erfahren, besuchen Sie dieSuchen und Ersetzen Dokumentationsartikel.

public class FindReplaceOptions

Konstrukteure

NameBeschreibung
FindReplaceOptions()Initialisiert eine neue Instanz der Klasse FindReplaceOptions mit Standardeinstellungen.
FindReplaceOptions(FindReplaceDirection)Initialisiert eine neue Instanz der Klasse FindReplaceOptions mit der angegebenen Richtung.
FindReplaceOptions(IReplacingCallback)Initialisiert eine neue Instanz der FindReplaceOptions-Klasse mit dem angegebenen Ersetzungs-Callback.
FindReplaceOptions(FindReplaceDirectionIReplacingCallback)Initialisiert eine neue Instanz der Klasse FindReplaceOptions mit der angegebenen Richtung und dem Ersetzungs-Callback.

Eigenschaften

NameBeschreibung
ApplyFont { get; }Textformatierung auf neuen Inhalt angewendet.
ApplyParagraphFormat { get; }Absatzformatierung auf neuen Inhalt angewendet.
Direction { get; set; }Wählt die Richtung für das Ersetzen. Der Standardwert istForward .
FindWholeWordsOnly { get; set; }„True“ bedeutet, dass der alte Wert ein eigenständiges Wort sein muss.
IgnoreDeleted { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text in gelöschten Revisionen ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreFieldCodes { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text in Feldcodes ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreFields { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text in Feldern ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreFootnotes { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Fußnoten ignoriert werden sollen. Der Standardwert istFALSCH .
IgnoreInserted { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text in eingefügten Revisionen ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreShapes { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Formen innerhalb eines Textes ignoriert werden sollen.
IgnoreStructuredDocumentTags { get; set; }Ruft einen booleschen Wert ab oder setzt ihn, der angibt, ob der Inhalt vonStructuredDocumentTag . Der Standardwert istFALSCH .
LegacyMode { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, dass der alte Suchen/Ersetzen-Algorithmus verwendet wird.
MatchCase { get; set; }„True“ bedeutet, dass beim Vergleich die Groß- und Kleinschreibung beachtet wird, „False“ bedeutet, dass beim Vergleich die Groß- und Kleinschreibung nicht beachtet wird.
ReplacementFormat { get; set; }Gibt das Format des Ersatzes an. Standard istText .
ReplacingCallback { get; set; }Die benutzerdefinierte Methode, die vor jedem Ersetzungsvorgang aufgerufen wird.
SmartParagraphBreakReplacement { get; set; }Ruft einen Booleschen Wert ab oder legt ihn fest, der angibt, ob der Absatz „break “ ersetzt werden darf, wenn kein nächster gleichgeordneter Absatz vorhanden ist.
UseLegacyOrder { get; set; }True gibt an, dass eine Textsuche sequenziell von oben nach unten unter Berücksichtigung der Textfelder durchgeführt wird. Der Standardwert istFALSCH .
UseSubstitutions { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Ersetzungen innerhalb von Ersetzungsmustern erkannt und verwendet werden sollen. Der Standardwert istFALSCH .

Beispiele

Zeigt, wie die Groß-/Kleinschreibung beim Ausführen einer Suchen-und-Ersetzen-Operation umgeschaltet wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Ruby bought a ruby necklace.");

// Wir können ein „FindReplaceOptions“-Objekt verwenden, um den Suchen-und-Ersetzen-Prozess zu ändern.
FindReplaceOptions options = new FindReplaceOptions();

// Setzen Sie das Flag „MatchCase“ auf „true“, um beim Suchen nach zu ersetzenden Zeichenfolgen die Groß-/Kleinschreibung zu berücksichtigen.
// Setzen Sie das Flag „MatchCase“ auf „false“, um die Groß-/Kleinschreibung bei der Suche nach zu ersetzendem Text zu ignorieren.
options.MatchCase = matchCase;

doc.Range.Replace("Ruby", "Jade", options);

Assert.AreEqual(matchCase ? "Jade bought a ruby necklace." : "Jade bought a Jade necklace.",
    doc.GetText().Trim());

Zeigt, wie eigenständige Such- und Ersetzungsvorgänge nur für Wörter umgeschaltet werden.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Jackson will meet you in Jacksonville.");

// Wir können ein „FindReplaceOptions“-Objekt verwenden, um den Suchen-und-Ersetzen-Prozess zu ändern.
FindReplaceOptions options = new FindReplaceOptions();

// Setzen Sie das Flag „FindWholeWordsOnly“ auf „true“, um den gefundenen Text zu ersetzen, wenn er nicht Teil eines anderen Wortes ist.
// Setzen Sie das Flag „FindWholeWordsOnly“ auf „false“, um den gesamten Text unabhängig von seiner Umgebung zu ersetzen.
options.FindWholeWordsOnly = findWholeWordsOnly;

doc.Range.Replace("Jackson", "Louis", options);

Assert.AreEqual(
    findWholeWordsOnly ? "Louis will meet you in Jacksonville." : "Louis will meet you in Louisville.",
    doc.GetText().Trim());

Siehe auch