Aspose.Words使用教程之在文件中找到並替換文字

Aspose.Words是一款先進的文件處理控制元件，在不使用Microsoft Words的情況下，它可以使使用者在各個應用程式中執行各種文件處理任務，其中包括文件的生成、修改、渲染、列印，文件格式轉換和郵件合併等文件處理。此外，Aspose.Words支援DOC，OOXML，RTF，HTML，OpenDocument, PDF, XPS, EPUB和其他格式。

使用範圍：在前的範圍內替換查詢或替換特定的字串，因為它會返回替換的數量,所以它是在沒有替換的條件下搜尋字串是非常有用的。如果一個捕獲或替換包含一個或多個特殊字元:段落,細胞破裂,部分斷裂,現場開始,欄位分隔符、欄位,內聯圖片,繪畫物件,腳註的字串時，會出現異常時。

在一定的範圍內，替代方法提供了幾個過載。以下是他們提供的可能性：

• 您可以指定一個字串被替換,一旦被替換，所有這個字串都將被替換,替換是否區分大小寫,或者只有獨立的單詞才會受到影響。注意一個詞被定義為僅由字母數字字元組成。如果只執行替換匹配的整個單詞,輸入字串包含了符號,那麼這個單詞不會被搜尋到。
• 您可以通過一個正規表示式模式用於查詢匹配和一個字串,然後替換它們。這種過載替換通過正規表示式捕捉到整個匹配。
• 你可以通過正規表示式模式和一個物件實現[{{ IReplacingCallback}}]介面。這提出了一個使用者定義的方法,它在每個步驟中評估替換,您也可以指示更換是應該向前還是向後的方向。建議如果在更換過程中要刪除節點那麼更換應該向後執行,以避免在更換過程中刪除節點有任何可能出現的潛在問題。一個實現回撥介面的類將定義一個 [IReplacingCallback.Replacing]方法，它接受提供定製的替換資料操作[{ { ReplacingArgs }}]物件。這個方法應該返回一個[{{ ReplaceAction }}]列舉值,指定當前匹配更換操作期間發生了什麼——它是否應該更換,跳過,或整個替換操作應該終止。

下面的例子展示如何使用前面提到的過載。樣例類提供的使用了Range.Replace 方法：

示例1 將所有出現的“sad”替換為“bad”。
示例2 將所有出現的“sad”或者“mad”替換成“bad”。
示例3 使用替換評估方法來連線出現的單詞“sad”或“bad”，每出現一次計數值相應增加。 

Example 1: 用一個詞換另一個詞

將所有出現的“sad”替換為“bad”。

Document doc = new Document(MyDir + @"in.docx");

doc.Range.Replace("sad", "bad", false, true);

Example 2: 用一個詞替換兩個相近的詞

使用“bad”替換所有“sad”和“mad”。

Document doc = new Document(MyDir + "Document.doc");

doc.Range.Replace(new Regex("[s|m]ad"), "bad");

Example 3:使用一個自定義計數器

如何替換為一個自定義計數器

public void ReplaceWithEvaluator()
{
    Document doc = new Document(MyDir + "Range.ReplaceWithEvaluator.doc");

    doc.Range.Replace(new Regex("[s|m]ad"), new MyReplaceEvaluator(), true);

    doc.Save(MyDir + "Range.ReplaceWithEvaluator Out.doc");
}

private class MyReplaceEvaluator : IReplacingCallback
{

    /// <summary>

    /// This is called during a replace operation each time a match is found.

    /// This method appends a number to the match string and returns it as a replacement string.

    /// </summary>

    ReplaceAction IReplacingCallback.Replacing(ReplacingArgs e)
    {
        e.Replacement = e.Match.ToString() + mMatchNumber.ToString();

        mMatchNumber++;

        return ReplaceAction.Replace;

    }
    private int mMatchNumber;
}