本文为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”。
C#
Document doc = new Document(MyDir + @"in.docx");
doc.Range.Replace("sad", "bad", false, true);
Visual Basic
Dim doc As New Document(MyDir & "Document.doc")
doc.Range.Replace("sad", "bad", False, True)
Example 2: 用一个词替换两个相近的词
使用“bad”替换所有“sad”和“mad”。
C#
Document doc = new Document(MyDir + "Document.doc");
doc.Range.Replace(new Regex("[s|m]ad"), "bad");
Visual Basic
Dim doc As New Document(MyDir & "Document.doc")
doc.Range.Replace(New Regex("[s|m]ad"), "bad")
Example 3:使用一个自定义计数器
如何替换为一个自定义计数器
C#
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;
}
Visual Basic
Public Sub ReplaceWithEvaluator()
Dim doc As New Document(MyDir & "Range.ReplaceWithEvaluator.doc")
doc.Range.Replace(New Regex("[s|m]ad"), New MyReplaceEvaluator(), True)
doc.Save(MyDir & "Range.ReplaceWithEvaluator Out.doc")
End Sub
Private Class MyReplaceEvaluator
Implements 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.
Private Function IReplacingCallback_Replacing(ByVal e As ReplacingArgs) As ReplaceAction Implements IReplacingCallback.Replacing
e.Replacement = e.Match.ToString() & mMatchNumber.ToString()
mMatchNumber += 1
Return ReplaceAction.Replace
End Function
Private mMatchNumber As Integer
End Class