FindReplaceOptions

FindReplaceOptions class

Specifica le opzioni per le operazioni di ricerca/sostituzione.

Per saperne di più, visita ilTrova e sostituisci articolo di documentazione.

public class FindReplaceOptions

Costruttori

NomeDescrizione
FindReplaceOptions()Inizializza una nuova istanza della classe FindReplaceOptions con impostazioni predefinite.
FindReplaceOptions(FindReplaceDirection)Inizializza una nuova istanza della classe FindReplaceOptions con la direzione specificata.
FindReplaceOptions(IReplacingCallback)Inizializza una nuova istanza della classe FindReplaceOptions con il callback di sostituzione specificato.
FindReplaceOptions(FindReplaceDirection, IReplacingCallback)Inizializza una nuova istanza della classe FindReplaceOptions con la direzione specificata e il callback di sostituzione.

Proprietà

NomeDescrizione
ApplyFont { get; }Formattazione del testo applicata al nuovo contenuto.
ApplyParagraphFormat { get; }Formattazione del paragrafo applicata al nuovo contenuto.
Direction { get; set; }Seleziona la direzione per la sostituzione. Il valore predefinito èForward .
FindWholeWordsOnly { get; set; }True indica che oldValue deve essere una parola autonoma.
IgnoreDeleted { get; set; }Ottiene o imposta un valore booleano che indica di ignorare il testo all’interno delle revisioni di eliminazione. Il valore predefinito èfalso .
IgnoreFieldCodes { get; set; }Ottiene o imposta un valore booleano che indica di ignorare il testo all’interno dei codici di campo. Il valore predefinito èfalso .
IgnoreFields { get; set; }Ottiene o imposta un valore booleano che indica di ignorare il testo all’interno dei campi. Il valore predefinito èfalso .
IgnoreFootnotes { get; set; }Ottiene o imposta un valore booleano che indica di ignorare le note a piè di pagina. Il valore predefinito èfalso .
IgnoreInserted { get; set; }Ottiene o imposta un valore booleano che indica di ignorare il testo all’interno delle revisioni di inserimento. Il valore predefinito èfalso .
IgnoreShapes { get; set; }Ottiene o imposta un valore booleano che indica di ignorare le forme all’interno di un testo.
IgnoreStructuredDocumentTags { get; set; }Ottiene o imposta un valore booleano che indica di ignorare il contenuto diStructuredDocumentTag . Il valore predefinito èfalso .
LegacyMode { get; set; }Ottiene o imposta un valore booleano che indica che viene utilizzato il vecchio algoritmo di ricerca/sostituzione.
MatchCase { get; set; }Vero indica un confronto con distinzione tra maiuscole e minuscole, falso indica un confronto senza distinzione tra maiuscole e minuscole.
ReplacementFormat { get; set; }Specifica il formato della sostituzione. Il valore predefinito èText .
ReplacingCallback { get; set; }Metodo definito dall’utente che viene chiamato prima di ogni occorrenza di sostituzione.
SmartParagraphBreakReplacement { get; set; }Ottiene o imposta un valore booleano che indica se è consentito sostituire il paragrafo break quando non esiste un paragrafo gemello successivo.
UseLegacyOrder { get; set; }Vero indica che una ricerca di testo viene eseguita in sequenza dall’alto verso il basso considerando le caselle di testo. Il valore predefinito èfalso .
UseSubstitutions { get; set; }Ottiene o imposta un valore booleano che indica se riconoscere e utilizzare le sostituzioni all’interno dei modelli di sostituzione. Il valore predefinito èfalso .

Esempi

Mostra come attivare o disattivare la distinzione tra maiuscole e minuscole quando si esegue un’operazione di ricerca e sostituzione.

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

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

// Possiamo utilizzare un oggetto "FindReplaceOptions" per modificare il processo di ricerca e sostituzione.
FindReplaceOptions options = new FindReplaceOptions();

// Imposta il flag "MatchCase" su "true" per applicare la distinzione tra maiuscole e minuscole durante la ricerca delle stringhe da sostituire.
// Impostare il flag "MatchCase" su "false" per ignorare la distinzione tra maiuscole e minuscole durante la ricerca del testo da sostituire.
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());

Mostra come attivare o disattivare operazioni di ricerca e sostituzione autonome di sole parole.

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

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

// Possiamo utilizzare un oggetto "FindReplaceOptions" per modificare il processo di ricerca e sostituzione.
FindReplaceOptions options = new FindReplaceOptions();

// Imposta il flag "FindWholeWordsOnly" su "true" per sostituire il testo trovato se non fa parte di un'altra parola.
// Imposta il flag "FindWholeWordsOnly" su "false" per sostituire tutto il testo, indipendentemente da ciò che lo circonda.
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());

Guarda anche