Find and replace options

FindOptions controls how the find and replace methods match text. The search is case sensitive by default. WholeWord matches whole words only, UseRegularExpressions treats the search text as a regular expression and substitutes group references such as $1 in the replacement text, UseWildcards enables the wildcards *, ? and [ ], Scope restricts the search to parts of the document and MaxResults limits the number of matches.

C# example - Case insensitive, whole words only

using System;
using Independentsoft.Office;
using Independentsoft.Office.Word;

namespace Sample
{
    class Program
    {
        static void Main(string[] args)
        {
            WordDocument doc = new WordDocument("c:\\test\\input.docx");

            FindOptions options = new FindOptions();
            options.MatchCase = false;
            options.WholeWord = true;

            //"cat" is replaced, "catalog" is not
            int count = doc.Replace("cat", "dog", options);

            Console.WriteLine(count + " occurrences replaced.");

            doc.Save("c:\\test\\output.docx", true);
        }
    }
}

C# example - Regular expressions

using System;
using Independentsoft.Office;
using Independentsoft.Office.Word;

namespace Sample
{
    class Program
    {
        static void Main(string[] args)
        {
            WordDocument doc = new WordDocument("c:\\test\\input.docx");

            FindOptions options = new FindOptions();
            options.UseRegularExpressions = true;

            //"Smith, John" becomes "John Smith"
            doc.Replace("([A-Za-z]+), ([A-Za-z]+)", "$2 $1", options);

            doc.Save("c:\\test\\output.docx", true);
        }
    }
}

C# example - Wildcards, scope and maximum number of results

using System;
using System.Collections.Generic;
using Independentsoft.Office;
using Independentsoft.Office.Word;

namespace Sample
{
    class Program
    {
        static void Main(string[] args)
        {
            WordDocument doc = new WordDocument("c:\\test\\input.docx");

            FindOptions options = new FindOptions(SearchScope.Body | SearchScope.HeadersAndFooters);
            options.UseWildcards = true;
            options.MaxResults = 10;

            IList<FindResult> results = doc.Find("Invoice *", options);

            foreach (FindResult result in results)
            {
                Console.WriteLine(result.Story + ": " + result.Text);
            }
        }
    }
}

VB example

Imports System
Imports Independentsoft.Office
Imports Independentsoft.Office.Word

Module Module1
    Sub Main(ByVal args As String())

        Dim doc As WordDocument = New WordDocument("c:\test\input.docx")

        Dim options As FindOptions = New FindOptions()
        options.MatchCase = False
        options.WholeWord = True

        Dim count As Integer = doc.Replace("cat", "dog", options)

        Console.WriteLine(count.ToString() + " occurrences replaced.")

        doc.Save("c:\test\output.docx", True)

    End Sub
End Module

Word .NET > Tutorial > Find and replace options

Need help? Ask our developers: