添加/编辑/搜索突出显示模式对话框

此对话框有助于创建和编辑自定义模式，这些模式可以检测与特定模式匹配的代码，并在必要时替换这些代码。

本主题描述了对话框中的控件。有关使用自定义模式搜索和替换代码的更多信息，请参阅结构化搜索和替换和创建自定义代码检查和快速修复。

此对话框可以以两种模式打开。

当您使用 ReSharper | 查找 | 使用模式搜索命令时（该命令在编辑器的上下文菜单中重复），对话框以搜索/替换模式打开，允许您直接从对话框底部使用相应的按钮开始搜索或替换。
当您在 ReSharper 选项的代码检查 | 自定义模式页面上使用添加模式/编辑按钮时，对话框以模式编辑模式打开，提供用于指定模式描述的附加字段。然而，在此模式下，搜索/替换按钮不可用。


语言选择器	允许选择模式的编程语言。 ReSharper 只会在指定的语言中找到匹配的代码。
查找/替换	使用这些选择器显示或隐藏替换模式。
模式目录	单击以打开 ReSharper 选项的代码检查 \| 自定义模式页面并查看现有模式列表。
最近搜索	单击以展开最近使用的自定义模式列表。

搜索区域


搜索模式	使用此编辑器通过纯文本和占位符输入您自己的搜索模式。
查找范围（在搜索/替换模式下可用）	使用此列表指定以下搜索范围之一：整个解决方案当前项目当前文件
模式严重性（在模式编辑模式下可用）	如果您将模式用作自定义代码检查，您可以使用列表指定其严重性级别。
匹配相似结构	使用此控件指定是否匹配相似的结构。 ReSharper 将以下结构视为相似：单行语句和用大括号括起来的单行语句。按模式指定的二元表达式及其反向顺序。按模式指定的表达式及操作数顺序不同的表达式。操作数用括号括起来的表达式和未用括号括起来的表达式。后缀和前缀递增运算符。具有不同访问修饰符的方法。
禁止键	如果您为模式指定了抑制键，您将能够通过注释抑制 ReSharper 检查，检测到模式的使用，例如： // ReSharper disable once [SuppressionKey] . 如果您希望通过单个注释抑制多个模式的检查，您可以为所有这些模式指定相同的抑制键。
描述（在模式编辑模式下可用）	此字段可选地让您指定在 ReSharper 选项的代码检查 \| 自定义模式页面上显示的模式描述。如果您将模式用作自定义代码检查，此描述将作为工具提示出现在编辑器中突出显示相应问题时，以及在检查结果中。

替换区域

此区域包含帮助您创建替换模式并指定替换后操作的控件。当您在对话框右上角选择替换时，此区域会出现。


替换模式	使用此编辑器通过纯文本和占位符输入替换模式。您只能使用搜索模式中定义的占位符。
替换后格式化	指定是否对替换模式生成的代码应用格式化。 You can configure code formatting options on the 代码编辑 \| 通用格式化样式 page of ReSharper 选项 `Alt+R, O` and/or on 代码编辑 \| [语言] \| 格式化样式 pages.
缩短引用	指定是否将完全限定名称替换为短名称。
描述（在模式编辑模式下可用）	此字段可选地让您指定在快速修复中显示的名称，如果您将模式用作自定义代码检查。

占位符区域


添加占位符	单击此按钮以创建新的占位符。有 5 种类型的占位符：参数占位符——方法调用中的一个或多个参数。如有必要，您可以指定应匹配的参数的最小或最大数量。表达式占位符——一系列运算符和操作数。您可以选择性地指定此表达式返回的类型。标识符占位符——任何符号标识符。您还可以额外指定一个正则表达式，用于匹配符号名称。语句占位符——以分号结尾的单行语句或语句块。如有必要，您可以指定应匹配的语句的最小或最大数量。类型占位符——值类型或引用类型。默认情况下，此类占位符将匹配任何类型，但您可以显式指定特定类型。您可以直接在搜索模式区域中键入一个新的占位符用法，例如 $statement$ ，新占位符将被添加到占位符列表中，您可以在其中编辑其类型和参数。单击此按钮时，将打开创建占位符对话框，您可以在其中选择占位符的类型、指定其名称和参数：此对话框中可以使用以下控件：名称 — 指定占位符名称（适用于所有占位符）。限制最小参数/语句数量 — 定义占位符出现的最小次数（适用于参数和语句占位符）。最大值 — 定义占位符出现的最大次数（适用于参数和语句占位符）。表达式类型/类型 — 从列表中选择一个项目以指定占位符的类型（适用于表达式和类型占位符）。或派生类型 — 选中此复选框以匹配具有所选类型或其派生类型的表达式或类型（适用于表达式和类型占位符）。标识符名称正则表达式 — 定义标识符名称的正则表达式（适用于标识符占位符）。区分大小写 — 指定标识符是否区分大小写（适用于标识符占位符）。
编辑	单击此按钮或双击占位符名称以使用创建/编辑占位符对话框编辑选定的占位符。
删除	单击此按钮以删除选定的占位符。请注意，您无法删除在搜索模式中使用的占位符。

添加占位符

单击此按钮以创建新的占位符。有 5 种类型的占位符：

参数占位符——方法调用中的一个或多个参数。如有必要，您可以指定应匹配的参数的最小或最大数量。
表达式占位符——一系列运算符和操作数。您可以选择性地指定此表达式返回的类型。
标识符占位符——任何符号标识符。您还可以额外指定一个正则表达式，用于匹配符号名称。
语句占位符——以分号结尾的单行语句或语句块。如有必要，您可以指定应匹配的语句的最小或最大数量。
类型占位符——值类型或引用类型。默认情况下，此类占位符将匹配任何类型，但您可以显式指定特定类型。

单击此按钮时，将打开创建占位符对话框，您可以在其中选择占位符的类型、指定其名称和参数：

此对话框中可以使用以下控件：

名称 — 指定占位符名称（适用于所有占位符）。
限制最小参数/语句数量 — 定义占位符出现的最小次数（适用于参数和语句占位符）。
最大值 — 定义占位符出现的最大次数（适用于参数和语句占位符）。
表达式类型/类型 — 从列表中选择一个项目以指定占位符的类型（适用于表达式和类型占位符）。
或派生类型 — 选中此复选框以匹配具有所选类型或其派生类型的表达式或类型（适用于表达式和类型占位符）。
标识符名称正则表达式 — 定义标识符名称的正则表达式（适用于标识符占位符）。
区分大小写 — 指定标识符是否区分大小写（适用于标识符占位符）。

编辑

单击此按钮或双击占位符名称以使用创建/编辑占位符对话框编辑选定的占位符。

删除

单击此按钮以删除选定的占位符。请注意，您无法删除在搜索模式中使用的占位符。

命令按钮


查找（在搜索/替换模式下，当替换模式隐藏时可用）	单击此按钮以执行搜索。
替换（在搜索/替换模式下，当替换模式显示时可用）	单击此按钮以查找模式出现的位置并指定要替换的位置。
保存	单击此按钮以使用智能保存逻辑将当前模式保存到目录。要稍后访问模式目录，请打开 ReSharper 选项的代码检查 \| 自定义模式页面。
保存副本（在模式编辑模式下可用）	单击此按钮以将当前模式的副本保存到目录。如果您想创建一个与当前模式类似的新模式，这可能会很有帮助。与“保存”命令类似，这里也适用智能保存逻辑。
关闭	单击此按钮以关闭对话框。

最后修改日期： 2025年 9月 27日

ReSharper 2025.2 Help