Error、IfError、IsError、IsBlankOrError 函数
适用于: 画布应用 Dataverse 公式列 桌面流 模型驱动应用 Power Pages Power Platform CLI
检测错误并提供替代值或执行操作。 创建自定义错误或传递错误。
备注
如果应用程序在已停用 的设置 更新 下>禁用了>公式级错误管理功能,则这些功能将无法正常工作。
IfError
IfError 函数会测试值,直到发现错误为止。 如果此函数发现错误,函数将求值,然后返回相应的替换值,并停止进一步的求值。 如果没有发现错误,也可能提供默认值。 IfError 的结构类似于 If 函数的结构:IfError 测试错误,而 If 测试是否为 true。
使用 IfError 将错误替换为有效值,以使下游计算可以继续。 例如,如果用户输入可能导致被零除,请使用此函数:
IfError( 1/x, 0 )
如果的值 0
为零,则返回 x
此公式,因为 1/x
会产生错误。 如果 x
不为零,则返回 1/x
。
停止进一步处理
Patch( DS1, ... );
Patch( DS2, ... )
即使对 DS1
的 Patch 失败,也会尝试对 DS2
运行第二个 Patch 函数。 错误的范围仅限于链接的每个公式。
使用 IfError 来执行操作,并且仅在操作成功后再继续处理。 将 IfError 应用于此示例:
IfError(
Patch( DS1, ... ), Notify( "problem in the first action" ),
Patch( DS2, ... ), Notify( "problem in the second action" )
)
如果 DS1
的 Patch 有问题,则执行第一个 Notify。 不会发生进一步的处理,包括 DS2
的第二个 Patch。 如果第一个 Patch 成功,将执行第二个 Patch。
如果提供,在未发现错误时,将返回可选的 DefaultResult 参数。 如果没有此参数,将返回最后一个 Value 参数。
基于上一个示例构建,可以检查 IfError 的返回值来确定是否存在任何问题:
IfError(
Patch( DS1, ... ), Notify( "problem in the first action" ); false,
Patch( DS2, ... ), Notify( "problem in the second action" ); false,
true
)
类型兼容性
IfError 返回其参数之一的值。 IfError 可能返回的所有值的类型必须兼容。
在最后一个示例中, Patch 返回与用于 Replacement 公式或 DefaultResult 的布尔值不兼容的记录。 这样很好,因为在任何情况下,IfError 都不会返回这些 Patch 调用的返回值。
备注
当更改的行为正在进行时,当前 IfError 的所有参数的类型都必须兼容。
在前面介绍的简单示例中:
IfError( 1/x, 0 )
1/x
和 0
的类型是兼容的,因为它们都是数字。 如果不是,则强制第二个参数以匹配第一个参数的类型。
Excel 显示 #DIV/0! 当发生除以零时。
考虑将 IfError 替换为以下内容:
IfError( 1/x, "#DIV/0!" )
上面的公式不起作用。 文本字符串 "#DIV/0!"
被强制为 IfError 的第一个参数的类型,即一个数字。 IfError 的结果是 另一个错误,因为文本字符串无法强制。 作为解决方法,将第一个参数转换为文本字符串,以让 IfError 始终返回文本字符串:
IfError( Text( 1/x ), "#DIV/0!" )
如上所示,如果 Replacement 或 DefaultResult 是错误,IfError 可能返回错误。
FirstError/AllErrors
在替换公式中,可通过 FirstError 记录和 AllErrors 表获得有关所发现的错误的信息。 AllErrors 是一个错误信息记录表,其中 FirstError 是此表的第一条记录的快捷方式。 FirstError 始终返回与 First(AllErrors) 相同的值。
错误记录包括:
字段 | 类型 | 说明 |
---|---|---|
类 | ErrorKind 枚举(数字) | 错误的类别。 |
消息 | 文本字符串 | 有关错误的消息,适合显示给最终用户。 |
源 | 文本字符串 | 错误发生的位置,用于报告。 例如,对于绑定到控件属性的公式,此值的格式为 ControlName.PropertyName。 |
观察 | 文本字符串 | 向用户显示错误的位置,用于报告。 例如,对于绑定到控件属性的公式,此值的格式为 ControlName.PropertyName。 |
详细信息 | 记录 | 有关错误的详细信息。 目前,仅提供网络错误的详细信息。 此记录包括包含 HTTP 状态代码的 HttpStatusCode,和包含来自连接器或服务的响应正文的 HttpResponse。 |
例如,将以下公式视为 Button 控件的 OnSelect 属性:
Set( a, 1/0 )
此公式在第二个按钮控件的 OnSelect 属性上:
IfError( a, Notify( "Internal error: originated on " & FirstError.Source & ", surfaced on " & FirstError.Observed ) )
当两个按钮按顺序激活时,上面的示例公式将显示以下横幅:
通常,只有一个 FirstError 可以充分处理的错误 。 但是,在某些情况下可能会返回多个错误。 例如,当使用公式链接运算符或 Concurrent 函数时。 即使在这些情况下,报告 FirstError 也有可能足以揭示问题,而不会向用户过载多个错误。 如果您仍然需要单独处理每个错误,可以使用 AllErrors 表。
IsError
IsError 函数测试错误值。
返回值为布尔值 true 或 false。
使用 IsError 可以防止对错误进行任何进一步的处理。
IsBlankOrError
IsBlankOrError 函数测试是否有空白值或错误值,等效于 Or( IsBlank( X ), IsError( X ) )
。
为现有应用启用错误处理时,考虑将 IsBlank 替换为 IsBlankOrError 以保留现有应用行为。 在添加错误处理之前, 空白 值用于表示数据库中的 null 值和错误值。 错误处理将两个空白解释分开,这可能会改变继续使用 IsBlank 的现有应用的行为。
返回值为布尔值 true 或 false。
使用 IsBlankOrError 可以防止对错误进行任何进一步的处理。
使用 Error 函数创建和报告自定义错误。 例如,您可能有逻辑来确定任何给定值对您的上下文是否有效—没有自动检查是否有问题的内容。 您可以创建并返回您自己的错误,包括 Kind 和 Message,使用上述 IfError 函数的相同记录。
在 IfError 的上下文中,使用 Error 函数重新抛出或传递错误。 例如,您在 IfError 中的逻辑可能决定在某些情况下可以安全地忽略错误,但在其他情况下,错误很重要,需要发送。 在 IfError 或 App.OnError 中,使用 Error( FirstError ) 传递错误。
也可以向 Error 函数传递一个错误表,如 AllErrors 表中的错误。 使用 Error( AllErrors ) 重新抛出所有错误,而不只是第一个。
传递给 Error 的空白记录或空表不会导致错误。
语法
错误( ErrorRecord )
错误( ErrorTable )
- ErrorRecord –必需。 错误消息记录,包括 Kind、Message 和其他字段。 kind 是必需的。 FirstError 可以直接传递。
- ErrorTable –必需。 错误信息记录表。 AllErrors 可以直接传递。
IfError(Value1,Replacement1 [, Value2,Replacement2 ,...[, DefaultResult ] ])
- values– 必需。 测试错误值的公式。
- Replacements(替换) –必需。 匹配的 Value 参数返回错误时要求值的公式和要返回的值。
- DefaultResult –可选。 公式未发现任何错误时要求值的公式。
IsError( 值 )
IsBlankOrError( 值 )
- Value –必需。 要测试的公式。
示例
简单的 IfError
公式 | 描述 | 结果 |
---|---|---|
IfError(1,2) | 第一个参数不是错误。 函数没有其他错误要检查,也没有默认返回值。 函数返回最后一个求值的 value 参数。 | 1 |
IfError(1/0,2) | 第一个参数返回一个错误值(由于除数为零)。 函数对第二个参数求值并将其作为结果返回。 | 2 |
IfError(10,20,30) | 第一个参数不是错误。 函数没有其他错误要检查,但有默认返回值。 函数返回 DefaultResult 参数。 | 30 |
IfError(10,11,20,21,300) | 第一个参数 10 不是错误,因此函数不对该参数的对应替换值 11 求值。 第三个参数 20 也不是错误,因此函数不对该参数的对应替换值 21 求值。 第五个参数 300 没有对应的替换值,是默认结果。 函数返回该结果,因为公式中不包含错误。 | 300 |
IfError(1/0,Notify(“存在内部问题”)) | 第一个参数返回一个错误值(因为除数为零)。 函数对第二个参数求值,并向用户显示一条消息。 IfError 的返回值是 Notify 的返回值,强制转换为与 IfError 的第一个参数相同的类型(数字)。 | 1 |
简单的 IsError
公式 | 描述 | 结果 |
---|---|---|
IsError(1) | 参数不是错误。 | 假 |
IsError(空白()) | 参数是空白,但不是错误。 | 假 |
IsError(1/0) | 参数是错误。 | 真 |
If(IsError(1/0),Notify(“存在内部问题”)) | IsError 的参数返回一个错误值(由于除数为零)。 此函数返回 true,这会导致 If 使用 Notify 函数向用户显示消息。 If 的返回值是 Notify 的返回值,强制转换为与 If 的第一个参数相同的类型(布尔)。 | 真 |
简单 IsBlankOrError
公式 | 描述 | 结果 |
---|---|---|
IsBlankOrError(1) | 参数不是错误或空白。 | 假 |
IsBlankOrError(空白()) | 参数是空白。 | 真 |
IsBlankOrError(1/0) | 参数是错误。 | 真 |
简单错误
在此示例中,日期是相对于彼此进行验证的,如果有问题,将会导致错误。
If( StartDate > EndDate,
Error( { Kind: ErrorKind.Validation, Message: "Start Date must be before End Date" } ) )
在此示例中,一些错误被允许传递,而另一些则被阻止并替换为一个值。 在第一种情况下, b 处于错误状态, 因为 Value 函数的参数无效。 由于公式编写器会意外地执行此操作,因此会传递此消息,以便用户能够看到此消息。 在第二种情况下,使用相同的公式, b 的值为 0,导致除以零。 在这种情况下,公式编写者可能知道这对于此逻辑是可以接受的,因而阻止错误(不显示横幅),改为返回 -1。
With( {a: 1, b: Value("a")},
IfError( a/b, If( FirstError.Kind <> ErrorKind.Div0, Error( FirstError ), -1 ) ) )
// returns an error with Kind = ErrorKind.InvalidArgument
With( {a: 1, b: 0} )
IfError( a/b, If( FirstError.Kind <> ErrorKind.Div0, Error( FirstError ), -1 ) ) )
// returns -1
AllErrors 表可以像任何其他表一样进行筛选。 与 Error 函数一起使用时,可以删除预期的错误,保留并报告其余错误。 例如,如果我们知道除以零在特定上下文中不会有问题,则可以使用以下公式过滤掉这些错误,使所有其他错误保持不变:
Error( Filter( AllErrors, Kind <> ErrorKind.Div0 ) )
分步操作
添加 Text input 控件,将它命名为 TextInput1(如果默认名称不是这样)。
添加 Label 控件,将它命名为 Label1(如果默认名称不是这样)。
将 Label1 的 Text 属性的公式设置为:
IfError( Value( TextInput1.Text ), -1 )
在 TextInput1 中,输入 1234。
Label1 显示值 1234 ,因为这是 Value 函数的有效输入。
在 TextInput1 中,输入 ToInfinity。
Label1 显示 value-1 ,因为这不是 Value 函数的有效输入。 在未使用 IfError 包装 Value 函数的情况下,标签将不会显示任何值,因为错误值被视为空白。