Trova e sostituisci
Puoi navigare facilmente all’interno del documento utilizzando tastiera e mouse, ma se hai molte pagine da scorrere, ci vorrà un po' di tempo per trovare il testo specifico in un documento lungo. Richiederà più tempo quando desideri sostituire determinati caratteri o parole che hai utilizzato nel tuo documento. La funzionalità “Trova e sostituisci” ti consente di trovare una sequenza di caratteri in un documento e sostituirla con un’altra sequenza di caratteri.
Aspose.Words ti consente di trovare una stringa specifica o un modello di espressione regolare nel tuo documento e sostituirlo con un’alternativa senza installare e utilizzare applicazioni aggiuntive come Microsoft Word. Ciò accelererà molte attività di digitazione e formattazione, risparmiando potenzialmente ore di lavoro.
Questo articolo spiega come applicare la sostituzione delle stringhe e le espressioni regolari con il supporto dei metacaratteri.
Modi per trovare e sostituire
Aspose.Words fornisce due modi per applicare l’operazione di ricerca e sostituzione utilizzando quanto segue:
- Sostituzione stringa semplice – per trovare e sostituire una stringa specifica con un’altra, è necessario specificare una stringa di ricerca (caratteri alfanumerici) che verrà sostituita in base a tutte le occorrenze con un’altra stringa di sostituzione specificata. Entrambe le stringhe non devono contenere simboli. Tieni presente che il confronto tra stringhe può fare distinzione tra maiuscole e minuscole, oppure potresti non essere sicuro dell’ortografia o avere diverse ortografie simili.
- Espressioni regolari – per specificare un’espressione regolare per trovare le corrispondenze esatte della stringa e sostituirle in base all’espressione regolare. Tieni presente che una parola è definita come composta solo da caratteri alfanumerici. Se la sostituzione viene eseguita con la corrispondenza solo di parole intere e la stringa di input contiene simboli, non verrà trovata alcuna frase.
Inoltre, puoi utilizzare metacaratteri speciali con semplici sostituzioni di stringhe ed espressioni regolari per specificare interruzioni all’interno dell’operazione di ricerca e sostituzione.
Aspose.Words presenta la funzionalità di ricerca e sostituzione con lo spazio dei nomi Aspose.Words.Replacing. Puoi lavorare con molte opzioni durante il processo di ricerca e sostituzione utilizzando la classe FindReplaceOptions.
Trova e sostituisci testo utilizzando la semplice sostituzione di stringhe
È possibile utilizzare uno dei metodi Replace per trovare o sostituire una stringa particolare e restituire il numero di sostituzioni effettuate. In questo caso, è possibile specificare una stringa da sostituire, una stringa che sostituirà tutte le sue occorrenze, se la sostituzione fa distinzione tra maiuscole e minuscole e se verranno influenzate solo le parole autonome.
L’esempio di codice seguente mostra come trovare la stringa “CustomerName” e sostituirla con la stringa “James Bond”:
Puoi notare la differenza tra il documento prima di applicare la semplice sostituzione della stringa:
E dopo aver applicato la semplice sostituzione della stringa:
Trova e sostituisci testo utilizzando le espressioni regolari
Un’espressione regolare (regex) è un modello che descrive una determinata sequenza di testo. Supponiamo di voler sostituire tutte le doppie occorrenze di una parola con un’occorrenza di parola singola. Quindi puoi applicare la seguente espressione regolare per specificare il modello a doppia parola: ([a-zA-Z]+) \1.
Utilizza l’altro metodo Replace per cercare e sostituire particolari combinazioni di caratteri impostando il parametro Regex come modello di espressione regolare per trovare corrispondenze.
L’esempio di codice seguente mostra come sostituire le stringhe che corrispondono a un modello di espressione regolare con una stringa di sostituzione specificata:
Puoi notare la differenza tra il documento prima di applicare la sostituzione della stringa con le espressioni regolari:
E dopo aver applicato la sostituzione delle stringhe con le espressioni regolari:
Trova e sostituisci la stringa utilizzando i metacaratteri
È possibile utilizzare i metacaratteri nella stringa di ricerca o nella stringa di sostituzione se un particolare testo o frase è composto da più paragrafi, sezioni o pagine. Alcuni metacaratteri includono &P per un’interruzione di paragrafo, &B per un’interruzione di sezione, &M per un’interruzione di pagina e &l per un’interruzione di riga.
L’esempio di codice seguente mostra come sostituire il testo con paragrafi e interruzioni di pagina:
Trova e sostituisci la stringa nell’intestazione/piè di pagina di un documento
Puoi trovare e sostituire il testo nella sezione intestazione/piè di pagina di un documento Word utilizzando la classe HeaderFooter.
Il seguente esempio di codice mostra come sostituire il testo della sezione di intestazione nel documento:
Puoi notare la differenza tra il documento prima di applicare la sostituzione della stringa di intestazione:
E dopo aver applicato la sostituzione della stringa di intestazione:
L’esempio di codice per sostituire il testo della sezione piè di pagina nel documento è molto simile all’esempio di codice di intestazione precedente. Tutto quello che devi fare è sostituire le seguenti due righe:
HeaderFooter header = headersFooters[HeaderFooterType.HeaderPrimary];
header.Range.Replace("Aspose.Words", "Remove", options);
Con quanto segue:
HeaderFooter footer = headersFooters[HeaderFooterType.FooterPrimary];
int currentYear = System.DateTime.Now.Year;
footer.Range.Replace("(C) 2006 Aspose Pty Ltd.", $"Copyright (C) {currentYear} by Aspose Pty Ltd.", options);
Puoi notare la differenza tra il documento prima di applicare la sostituzione della stringa del piè di pagina:
E dopo aver applicato la sostituzione della stringa del piè di pagina:
Ignora testo durante Trova e sostituisci
Durante l’applicazione dell’operazione di ricerca e sostituzione, puoi ignorare alcuni segmenti del testo. Pertanto, alcune parti del testo possono essere escluse dalla ricerca e la ricerca e sostituzione può essere applicata solo alle parti rimanenti.
Aspose.Words fornisce molte proprietà di ricerca e sostituzione per ignorare testo come IgnoreDeleted, IgnoreFieldCodes, IgnoreFields, IgnoreFootnotes e IgnoreInserted.
L’esempio di codice seguente mostra come ignorare il testo all’interno delle revisioni di eliminazione:
Personalizza l’operazione Trova e sostituisci
Aspose.Words fornisce molti properties diversi per trovare e sostituire testo, ad esempio applicando un formato specifico con proprietà ApplyFont e ApplyParagraphFormats, utilizzando sostituzioni in modelli di sostituzione con proprietà UseSubstitutions e altro.
Il seguente esempio di codice mostra come evidenziare una parola specifica nel documento:
Aspose.Words consente di utilizzare l’interfaccia IReplacingCallback per creare e chiamare un metodo personalizzato durante un’operazione di sostituzione. Potresti avere alcuni casi d’uso in cui è necessario personalizzare l’operazione di ricerca e sostituzione, ad esempio sostituire il testo specificato con un’espressione regolare con tag HTML, quindi in pratica applicherai la sostituzione inserendo HTML.
Se devi sostituire una stringa con un tag HTML, applica l’interfaccia IReplacingCallback per personalizzare l’operazione di ricerca e sostituzione in modo che la corrispondenza inizi all’inizio di un’esecuzione con il nodo di corrispondenza del documento. Forniamo diversi esempi di utilizzo di IReplacingCallback.
L’esempio di codice seguente mostra come sostituire il testo specificato con HTML:
Il seguente esempio di codice mostra come evidenziare i numeri positivi con il colore verde e i numeri negativi con il colore rosso:
L’esempio di codice seguente mostra come anteporre un numero di riga a ciascuna riga: