IsMatch、 Match和 MatchAll 函数

适用于： 画布应用 Copilot Studio 模型驱动应用 Power Platform CLI Dataverse 函数 Power Pages

根据模式测试匹配或提取文本字符串的各个部分。

描述

该 IsMatch 函数测试文本字符串是否匹配可构成普通字符、预定义模式或 正则表达式的模式。 Match和MatchAll函数返回匹配的内容，包括子匹配项。

用于 IsMatch 验证用户在 文本输入 控件中键入的内容。 例如，在结果保存到数据源之前，请确认用户是否输入了有效的电子邮件地址。 如果条目与条件不匹配，请添加其他控件，提示用户修复该条目。

用于 Match 提取与模式匹配的第一个文本字符串，以及 MatchAll 提取匹配的所有文本字符串。 提取子匹配项以分析复杂字符串。

Match 返回找到的第一个匹配项的信息记录，并 MatchAll 返回找到的每个匹配项的记录表。 记录包含：

这些函数支持 MatchOptions。 默认情况下：

• 这些函数执行区分大小写的匹配。 使用 MatchOptions.IgnoreCase 执行不区分大小写的匹配。
• IsMatch匹配整个文本字符串（Complete MatchOption），同时MatchMatchAll搜索文本字符串（包含 MatchOption）中的任意位置的匹配项。 请根据您的情况使用 Complete、Contains、BeginsWith 或 EndsWith。

IsMatch 如果文本字符串与模式匹配，则返回 true ;否则返回 false 。 Match如果未找到可使用 IsBlank 函数测试的匹配项，则返回空。 MatchAll 如果未找到可以使用 IsEmpty 函数测试的匹配项，则返回空表。

如果使用 MatchAll 拆分文本字符串，请考虑使用 Split 函数，该函数更简单、更快。

模式

使用这些函数的关键在于描述要匹配的模式。 您可以组合使用以下文本字符串来描述模式：

• 普通字符，如 "abc" 或 "123"。
• 预定义模式，如 Letter、MultipleDigits 或 Email。 Match（枚举定义这些模式。
• 正则表达式代码，如 "\d+\s+\d+" 或 "[a-z]+"。

使用 字符串串联运算符 合并这些元素。 例如，"abc" & Digit & "\s+" 是一个有效的模式，它表示首先要与字符“a”、“b”和“c”匹配，后面跟一个从 0 到 9 的数字，后面再跟至少一个空格字符。

普通字符

最简单的模式是一系列完全匹配的普通字符。

例如，与函数一起使用 IsMatch 时，字符串“Hello”与模式 “Hello” 完全匹配。 不多不少，正好相符。 字符串 "hello!" 与模式不匹配，因为末尾的感叹号和字母“h”的情况不正确。 （请参阅Match修改此行为的方法的选项。

在模式语言中，字符 . ? * + ( ) [ ] ^ $ | \ 保留为特殊用途。 若要使用这些字符，请为字符添加前缀 \ （反斜杠），以指示应从字面上获取该字符，或使用预定义模式之一。 例如，可以在问号前将模式"Hello?"与反斜杠一起使用来匹配字符串"Hello\\?"。

预定义模式

预定义模式提供了一种简单方法来匹配一组字符中的一个字符或一个多字符序列。 使用 字符串串联运算符 并将 自己的文本字符串与枚举的成员 Match 组合在一起：

例如，模式 “A”和 MultipleDigits 与字母“A”匹配，后跟一个或多个数字。

Power Apps 使用不同的定义。MatchEMail 和 Match.连字符。 计算 Text( Match.Email ) 结果以查看主机使用的正则表达式。

正则表达式

这些函数使用的模式称为 正则表达式。 Power Fx 的特定正则表达式方言在 Power Fx 中的正则表达式中详细介绍。

正则表达式功能强大，用途多种多样。 它们还可以看起来像随机标点符号序列。 本文没有描述正则表达式的所有方面，但在线提供了 wealth 的信息、教程和工具。

正则表达式有着悠久的历史，并且有多种编程语言版本。 每种编程语言都有自己的正则表达式方言，而且标准很少。 我们努力确保所有 Power Fx 实现都使用相同的正则表达式。 兼容性并不容易实现，因为 Power Fx 在 JavaScript 和 .NET 之上运行，它们有显着差异。 为了适应在不同平台上的运行，Power Fx 正则表达式仅限于整个行业广受支持的功能子集。

因此，某些可在其他环境中工作的正则表达式可能会被阻止，或者需要在 Power Fx 中进行调整。 当遇到不受支持的功能时，将报告创作时间错误。 这是正则表达式和选项必须是创作时间常量而不是动态（例如，在变量中提供）的原因之一。

以下是正则表达式的一些基本元素，这些元素在分析数字时会建立复杂性。

这些示例只提供正则表达式可以执行的作的一小部分。 它们通常用于验证 ID 号码、电子邮件地址、电话号码、日期和时间，以及从所有类型的文本文件中提取信息。 通过阅读 Power Fx 中的正则表达式、试验和使用 Web 了解详细信息，继续你的旅程。

Match 选项

通过指定一个或多个使用字符串串联运算符（>）组合的选项来修改这些函数的行为。

使用 MatchAll 与对正则表达式使用标准“g”修饰符相同。

语法

IsMatch（ 文本、 模式 [、 选项 ] ）

• Text –必需。 要测试的文本字符串。
• pattern –必需。 要作为文本字符串测试的模式。 连接枚举定义或提供正则表达式的预定义模式 Match 。 模式 必须是没有变量、数据源或其他动态引用的常量公式，在应用运行时更改。 请注意，公式必须表示为“Match。PredefinedPattern“，例如 Match。电子邮件
• Options（选项） –可选。 MatchOptions 枚举值的文本字符串组合。 默认情况下，使用 MatchOptions.Complete。 选项 必须是不带变量、数据源或其他动态引用的常量公式，在应用运行时更改。

Match（ 文本、 模式 [、 选项 ] ）

• Text –必需。 要匹配的文本字符串。
• pattern –必需。 要作为文本字符串匹配的模式。 连接枚举定义的预定义模式 Match ，或提供正则表达式。 Pattern 必须是一个常量公式，不包含任何变量、数据源或其他随着应用程序运行而变化的动态引用。
• Options（选项） –可选。 MatchOptions 枚举值的文本字符串组合。 默认情况下，使用 MatchOptions.Contains。 选项 必须是一个常量公式，没有任何变量、数据源或其他动态引用在应用运行时发生更改。

MatchAll（ 文本、 模式 [、 选项 ] ）

• Text –必需。 要匹配的文本字符串。
• pattern –必需。 要作为文本字符串匹配的模式。 连接枚举定义或提供正则表达式的预定义模式 Match 。 模式 必须是没有变量、数据源或其他动态引用的常量公式，在应用运行时更改。
• Options（选项） –可选。 MatchOptions 枚举值的文本字符串组合。 默认情况下，使用 MatchOptions.Contains。 选项 必须是不带变量、数据源或其他动态引用的常量公式，在应用运行时更改。

IsMatch 例子

普通字符

假设你的应用有一个名为 TextInput1的文本输入控件。 用户在此控件中输入值以将它们存储在数据库中。

用户在 TextInput1 中键入 Hello world。

预定义模式

正则表达式

Match 和 MatchAll 示例

让我们深入探索一下最后一个示例。 如果要使用 Time 函数将此字符串转换为日期/时间值，则必须单独传入命名的子匹配项。 为此，请使用对返回的记录Match进行作的 With 函数：

With(
    Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
   Time( Value( hours ), Value( minutes ), Value( seconds ) )
)

对于这些示例，添加一个 Button 控件，将其 OnSelect 属性设置为此公式，然后选择按钮：

Set( pangram, "The quick brown fox jumps over the lazy dog." )

公式	描述	结果
Match( pangram, "THE", IgnoreCase )	在 pangram 变量包含的文本字符串中查找“THE”的所有匹配项。 字符串包含两个匹配项，但只返回第一个匹配项，因为你正在使用而不是 MatchAll。Match	{ FullMatch：“The”， StartMatch：32 }
MatchAll( pangram, "the" )	在 pangram 变量包含的文本字符串中找到“the”的所有匹配项。 此测试区分大小写，因此仅找到“the”的第二个实例。
MatchAll( pangram, "the", IgnoreCase )	在 pangram 变量包含的文本字符串中找到“the”的所有匹配项。 在此例中，测试不区分大小写，因此找到了该单词的全部两个实例。
MatchAll( pangram, "\b\wo\w\b" )	查找所有三个字母的单词，中间带有“o”。 “brown”被排除，因为它不是三个字母单词，因此，无法匹配“\b”（字边界）。
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	匹配“fox”和“dog”之间的所有字符。	{ between： “跳过懒惰”， FullMatch：“狐狸跳过懒狗”， StartMatch：17 }

若要查看库中的结果 MatchAll ：

1. 在空屏幕中，插入空白的垂直 库 控件。

2. 将库的 Items 属性设置为MatchAll（pangram、“\w+”）或MatchAll（pangram、MultipleLetters）。

   

3. 在 Gallery 控件的中间选择“从‘插入’选项卡添加项”，以选择库的模板。

4. 将 Label 控件添加到库的模板中。

5. 将标签的 Text 属性设置为 ThisItem.FullMatch。

   库已填充了我们的示例文本中的每个单词。 若要查看一个屏幕上的所有字词，请调整库的模板和标签控件的大小。