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()Default_Constructor
FindReplaceOptions(FindReplaceDirection)
FindReplaceOptions(IReplacingCallback)
FindReplaceOptions(FindReplaceDirectionIReplacingCallback)

Eigenschaften

NameBeschreibung
ApplyFont { get; }Textformatierung wird auf neue Inhalte angewendet.
ApplyParagraphFormat { get; }Absatzformatierung wird auf neuen Inhalt angewendet.
Direction { get; set; }Wählt die Richtung zum Ersetzen aus. Der Standardwert istForward .
FindWholeWordsOnly { get; set; }True gibt an, dass der alte Wert ein eigenständiges Wort sein muss.
IgnoreDeleted { get; set; }Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob Text in Löschrevisionen 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 Einfügungsrevisionen ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreShapes { get; set; }Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob Formen innerhalb eines Textes ignoriert werden sollen.
IgnoreStructuredDocumentTags { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob der Inhalt ignoriert werden sollStructuredDocumentTag . Der Standardwert istFALSCH .
LegacyMode { get; set; }Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, dass der alte Such-/Ersetzungsalgorithmus verwendet wird.
MatchCase { get; set; }„True“ gibt einen Vergleich unter Berücksichtigung der Groß-/Kleinschreibung an, „false“ zeigt einen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung an.
ReplacingCallback { get; set; }Die benutzerdefinierte Methode, die vor jedem Ersetzen 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 der Reihe nach von oben nach unten unter Berücksichtigung der Textfelder durchgeführt wird. Der Standardwert istFALSCH .
UseSubstitutions { get; set; }Ruft einen booleschen Wert ab, der angibt, ob Ersetzungen innerhalb von Ersetzungsmustern erkannt und verwendet werden sollen, oder legt diesen fest. Der Standardwert istFALSCH .

Beispiele

Zeigt, wie die Groß-/Kleinschreibung beim Durchführen eines Suchen-und-Ersetzen-Vorgangs 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 Such- und Ersetzungsprozess zu ändern.
FindReplaceOptions options = new FindReplaceOptions();

// Setzen Sie das Flag „MatchCase“ auf „true“, um bei der Suche 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 Such- und Ersetzungsprozess 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