PREVIEW

VerifyRange

验证表达式是否位于给定范围内。

定义

命名空间： UiPath.Testing.API

程序集： UiPath.Testing.Activities.Api（在 UiPath.Testing.Activities.Api.dll 中）

重载

VerifyRange(object,VerificationType, object, string)	验证表达式是否位于给定范围内。
VerifyRange(object,VerificationType, object, object,string, bool, string, bool, bool)	验证表达式是否位于给定范围内。 除了验证之外，您还可以执行其他配置，例如配置输出消息格式，或在断言失败时截取屏幕截图。

VerifyRange(object,VerificationType, object, string)

验证表达式是否位于给定范围内。

bool 验证范围(
	对象表达式,
	验证类型验证类型,
	对象下限,
	对象上限
)

表达式 对象

要在给定范围内验证的表达式。

验证类型 验证类型

选择验证类型 - 范围内或范围外:

• IsWithin
• IsNotWithin

下限 对象

范围的下限。

上限 对象

范围的上限。

输出消息格式 字符串

输出消息格式。支持的参数包括：

• {Expression}
• {ExpressionText}
• {Operator}
• {LowerLimit}
• {LowerLimitText}
• {UpperLimit}
• {UpperLimitText}
• {Result}

有关更多信息，请查看“配置 outputMessageFormat”部分。

VerifyRange(Object,VerificationType, Object, Object,String, Boolean, String, Boolean, Boolean)

验证表达式是否位于给定范围内。您还可以执行验证以外的其他配置，例如配置输出消息格式，或者在断言失败时截取屏幕截图。

bool 验证范围(
	对象表达式,
	验证类型验证类型,
	对象下限,
	对象上限,
	字符串 outputMessageFormat,
	布尔值继续失败,
	
	字符串替代验证标题, 布尔拍摄截图以防失败断言,
	bool拍摄屏幕截图InCaseOfSucceedingAssertion
)

表达式 对象

要在给定范围内验证的表达式。

验证类型 验证类型

选择验证类型 - 范围内或范围外:

• IsWithin
• IsNotWithin

下限 对象

范围的下限。

上限 对象

范围的上限。

输出消息格式 字符串

输出消息格式。支持的参数包括：

• {Expression}
• {ExpressionText}
• {Operator}
• {LowerLimit}
• {LowerLimitText}
• {UpperLimit}
• {UpperLimitText}
• {Result}

有关更多信息，请查看“配置 outputMessageFormat”部分。

失败时继续 布尔值

指定如果活动引发错误，是否仍应继续自动化。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

可选验证名称 字符串

这将在 Orchestrator 中显示。

在断言失败的情况下截取屏幕截图 布尔值

如果设置为 True，则在验证失败时截取目标流程的屏幕截图。

在断言成功的情况下获取屏幕截图 布尔值

如果设置为 True，则在验证成功后截取目标流程的屏幕截图。

返回值

布尔值

如果验证通过/成功，则为“True”；如果验证失败，则为“False”。

配置outputMessageFormat

outputMessageFormat 参数可以配置受支持的参数，这些参数可充当验证操作中所用值的占位符。这些占位符将自动填充为您在运行时调用 API 时定义的变量或值。

对于验证范围 API，您可以在创建输出消息时实现以下支持的参数：

• {Expression}：表示您为 expression 参数提供的表达式的值。
• {ExpressionText}：表示您为 expression 参数插入的表达式的文本。
• {Operator}：对应 verificationType 参数。
• {LowerLimit}：表示用于 lowerLimit 参数的变量名称。
• {LowerLimitText}：指用于 lowerLimit 参数的变量的文本表示。
• {UpperLimit}：表示用于 upperLimit 参数的变量名称。
• {UpperLimitText}：指用于 upperLimit 参数的变量的文本值。
• {Result}：表示 API 的返回值，即验证结果。

以下示例说明如何使用验证范围 API，其中包括配置 outputMessageFormat 参数：

// Initialize a variable for the expression to be verified
var Expression1 = 23;

// Employ the VerifyRange API, with the last string parameter being the outputMessageFormat
testing.VerifyRange(Expression1, VerificationType.IsWithin, 1, 25, "The {Expression} should be greater than {LowerLimitText}, and less than {UpperLimitText}");

在提供的示例中，大括号中的占位符在运行时替换为相应的变量名称及其值，从而提供自定义的输出消息。