Interop.Word 上 Find.Execute 的正确语法是什么？
What is the correct syntax for Find.Execute on Interop.Word?
我在使用 Microsoft.Office.Interop.Word 时遇到问题 - 尝试执行查找并替换为格式设计更改。
最令人沮丧的是我没有收到错误，只是 Word 应用程序卡住了。
我正在检查如何在 Interop Word 上使用 Find.Execute 因为它需要通过 Object - 我无法弄清楚这样做的正确方法是什么，我发现不同探索这个问题的方法。
让我们假设我有这种代码：
using msWord = Microsoft.Office.Interop.Word;
msWord.Document doc = msWord.Application.ActiveDocument; // sets the document
Range range = doc.StoryRanges[WdStoryType.wdMainTextStory]; // sets the range as the main text
string textToFind = "ABC"; // the text to be found
string textToReplace = "123"; // the text to replace with
bool useWildCards = false; // whether to use wildcards on search
bool makeBold = true; // whether to change the font format to bold or non-bold
现在我正在执行这样的查找和替换功能：
FindAndReplaceWithFormating(range ,textToFind ,textToReplace, useWildCards, makeBold)
现在我的问题是如何以正确和最合适的方法使这个 FindAndReplaceWithFormating 发挥作用。为此，我在这里有 3 种不同的方法：
private void FindAndReplaceWithFormating(Range range, string textToFind,
string textToReplace, bool useWildCards, bool makeBold)
{
range.Find.ClearFormatting();
range.Find.Replacement.ClearFormatting();
range.Find.Replacement.Font.Bold = makeBold; // the format design must come like this.
// here comes the rest of the code according to the chosen method...
}
方法一：
range.Find.Text = textToFind;
range.Find.Replacement.Text = textToReplace;
range.Find.MatchWildcards = useWildCards;
range.Find.Forward = true;
range.Find.Format = true;
range.Find.Wrap = msWord.WdFindWrap.wdFindContinue;
object replaceAll = msWord.WdReplace.wdReplaceAll;
object missing = Missing.Value; // using System.Reflection;
// all ref are missing. only replaceAll ref is sent
range.Find.Execute(ref missing, ref missing, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing, ref missing,
ref replaceAll, ref missing, ref missing, ref missing, ref missing);
方法二：
object missing = Missing.Value;
object FindText = textToFind;
object MatchCase = missing;
object MatchWholeWord = missing;
object MatchWildcards = useWildCards;
object MatchSoundsLike = missing;
object MatchAllWordForms = missing;
object Forward = true;
object Wrap = msWord.WdFindWrap.wdFindContinue;
object Format = true;
object ReplaceWith = textToReplace;
object Replace = msWord.WdReplace.wdReplaceAll;
object MatchKashida = missing;
object MatchDiacritics = missing;
object MatchAlefHamza = missing;
object MatchControl = missing;
// all are sent as object.
find.Execute(ref FindText, ref MatchCase, ref MatchWholeWord, ref MatchWildcards, ref MatchSoundsLike,
ref MatchAllWordForms, ref Forward, ref Wrap, ref Format, ref ReplaceWith, ref Replace,
ref MatchKashida, ref MatchDiacritics, ref MatchAlefHamza, ref MatchControl);
方法 2b：
// same as above just objects are sent without ref
// ...
find.Execute(FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike,
MatchAllWordForms, Forward, Wrap, Format, ReplaceWith, Replace,
MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl);
方法三：
range.Find.Execute(textToFind, false, false, useWildCards, false, false, true,
msWord.WdFindWrap.wdFindContinue, true, textToReplace, msWord.WdReplace.wdReplaceAll,
false, false, false, false);
感谢@Yosef Bernal，我再次检查了这个，发现所有方法都是正确的。但似乎有一种最受青睐的方法，因为它的清晰度是声明所有属性，并以“可读”的方式排列它，如下所示：
range.Find.Execute(
FindText: "ABC", // The text to be searched for.
ReplaceWith: "123", // The replacment text.
MatchWildcards: false, // Determines if the text to find contains wildcards.
Forward: true, // Determines if the find operation searches forward through the document.
Format: false, // Determine if formatting is included in the find operation.
Wrap: WdFindWrap.wdFindContinue, // What happens if the search begins at a point other than the beginning of the document and the end of the document is reached (or vice versa if Forward is set to False) or if the search text isn't found in the specified selection or range.
Replace: WdReplace.wdReplaceAll, // Specifies how many replacements to be made: one , none or all.
MatchCase: false, // Determines if the find operation is case-sensitive.
MatchWholeWord: false, // Determines if the find operation locates only entire words and not text that's part of a larger word.
MatchSoundsLike: false, // Determines if words that sound similar to the text to find are returned by the find operation.
MatchAllWordForms: false, // Determines if all forms of the text to find are found by the find operation (for instance, if the text to find is "sit," "sat" and "sitting" are found as well).
MatchKashida: false, // Match text with matching kashidas in an Arabic language document.
MatchDiacritics: false, // Matching diacritics in a right-to-left language document.
MatchAlefHamza: false, // Match text with matching alef hamzas in an Arabic language document.
MatchControl: false // Matching bidirectional control characters in a right-to-left language document.
);
编辑：
请注意将 UndoRecord 与 ReplaceAll 一起使用时的 Interop.Word 错误 - 请参阅 here & here
我在使用 Microsoft.Office.Interop.Word 时遇到问题 - 尝试执行查找并替换为格式设计更改。
最令人沮丧的是我没有收到错误，只是 Word 应用程序卡住了。
我正在检查如何在 Interop Word 上使用 Find.Execute 因为它需要通过 Object - 我无法弄清楚这样做的正确方法是什么，我发现不同探索这个问题的方法。
让我们假设我有这种代码：
using msWord = Microsoft.Office.Interop.Word;
msWord.Document doc = msWord.Application.ActiveDocument; // sets the document
Range range = doc.StoryRanges[WdStoryType.wdMainTextStory]; // sets the range as the main text
string textToFind = "ABC"; // the text to be found
string textToReplace = "123"; // the text to replace with
bool useWildCards = false; // whether to use wildcards on search
bool makeBold = true; // whether to change the font format to bold or non-bold
现在我正在执行这样的查找和替换功能：
FindAndReplaceWithFormating(range ,textToFind ,textToReplace, useWildCards, makeBold)
现在我的问题是如何以正确和最合适的方法使这个 FindAndReplaceWithFormating 发挥作用。为此，我在这里有 3 种不同的方法：
private void FindAndReplaceWithFormating(Range range, string textToFind,
string textToReplace, bool useWildCards, bool makeBold)
{
range.Find.ClearFormatting();
range.Find.Replacement.ClearFormatting();
range.Find.Replacement.Font.Bold = makeBold; // the format design must come like this.
// here comes the rest of the code according to the chosen method...
}
方法一：
range.Find.Text = textToFind;
range.Find.Replacement.Text = textToReplace;
range.Find.MatchWildcards = useWildCards;
range.Find.Forward = true;
range.Find.Format = true;
range.Find.Wrap = msWord.WdFindWrap.wdFindContinue;
object replaceAll = msWord.WdReplace.wdReplaceAll;
object missing = Missing.Value; // using System.Reflection;
// all ref are missing. only replaceAll ref is sent
range.Find.Execute(ref missing, ref missing, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing, ref missing,
ref replaceAll, ref missing, ref missing, ref missing, ref missing);
方法二：
object missing = Missing.Value;
object FindText = textToFind;
object MatchCase = missing;
object MatchWholeWord = missing;
object MatchWildcards = useWildCards;
object MatchSoundsLike = missing;
object MatchAllWordForms = missing;
object Forward = true;
object Wrap = msWord.WdFindWrap.wdFindContinue;
object Format = true;
object ReplaceWith = textToReplace;
object Replace = msWord.WdReplace.wdReplaceAll;
object MatchKashida = missing;
object MatchDiacritics = missing;
object MatchAlefHamza = missing;
object MatchControl = missing;
// all are sent as object.
find.Execute(ref FindText, ref MatchCase, ref MatchWholeWord, ref MatchWildcards, ref MatchSoundsLike,
ref MatchAllWordForms, ref Forward, ref Wrap, ref Format, ref ReplaceWith, ref Replace,
ref MatchKashida, ref MatchDiacritics, ref MatchAlefHamza, ref MatchControl);
方法 2b：
// same as above just objects are sent without ref
// ...
find.Execute(FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike,
MatchAllWordForms, Forward, Wrap, Format, ReplaceWith, Replace,
MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl);
方法三：
range.Find.Execute(textToFind, false, false, useWildCards, false, false, true,
msWord.WdFindWrap.wdFindContinue, true, textToReplace, msWord.WdReplace.wdReplaceAll,
false, false, false, false);
感谢@Yosef Bernal，我再次检查了这个，发现所有方法都是正确的。但似乎有一种最受青睐的方法，因为它的清晰度是声明所有属性，并以“可读”的方式排列它，如下所示：
range.Find.Execute(
FindText: "ABC", // The text to be searched for.
ReplaceWith: "123", // The replacment text.
MatchWildcards: false, // Determines if the text to find contains wildcards.
Forward: true, // Determines if the find operation searches forward through the document.
Format: false, // Determine if formatting is included in the find operation.
Wrap: WdFindWrap.wdFindContinue, // What happens if the search begins at a point other than the beginning of the document and the end of the document is reached (or vice versa if Forward is set to False) or if the search text isn't found in the specified selection or range.
Replace: WdReplace.wdReplaceAll, // Specifies how many replacements to be made: one , none or all.
MatchCase: false, // Determines if the find operation is case-sensitive.
MatchWholeWord: false, // Determines if the find operation locates only entire words and not text that's part of a larger word.
MatchSoundsLike: false, // Determines if words that sound similar to the text to find are returned by the find operation.
MatchAllWordForms: false, // Determines if all forms of the text to find are found by the find operation (for instance, if the text to find is "sit," "sat" and "sitting" are found as well).
MatchKashida: false, // Match text with matching kashidas in an Arabic language document.
MatchDiacritics: false, // Matching diacritics in a right-to-left language document.
MatchAlefHamza: false, // Match text with matching alef hamzas in an Arabic language document.
MatchControl: false // Matching bidirectional control characters in a right-to-left language document.
);
编辑：
请注意将 UndoRecord 与 ReplaceAll 一起使用时的 Interop.Word 错误 - 请参阅 here & here