指示提取的值是否是从 HtmlDocument 所包含的全部匹配项中随机选择的。
命名空间： Microsoft.VisualStudio.TestTools.WebTesting.Rules
程序集： Microsoft.VisualStudio.QualityTools.WebTestFramework（在 Microsoft.VisualStudio.QualityTools.WebTestFramework.dll 中）
语法
声明
Public Property ExtractRandomMatch As Boolean
Get
Set
public bool ExtractRandomMatch { get; set; }
public:
property bool ExtractRandomMatch {
bool get ();
void set (bool value);
}
member ExtractRandomMatch : bool with get, set
function get ExtractRandomMatch () : boolean
function set ExtractRandomMatch (value : boolean)
属性值
类型：System.Boolean
一个布尔值，指示提取的值是否是从 HtmlDocument 所包含的全部匹配项中随机选择的。
备注
如果希望某个值是从 XML 文档所包含的全部匹配项中随机选择出来的，请将该属性设置为 rue。 请在创建提取规则时设置该属性。 然后，Web 性能测试运行时引擎在收到对 WebTestRequest 的 HTML 响应之后调用 Extract()。 调用 Extract() 时不会更改 ExtractRandomMatch 属性的值。
通常是在创建 ExtractText 提取规则之后、返回 WebTestRequest 之前，在 GetRequestEnumerator 中的编码的 Web 性能测试中设置 ExtractRandomMatch 属性。
示例
下面的示例显示的是一个编码的 Web 性能测试，它的代码是通过代码生成而产生的。 生成这些代码后未对其进行手动修改。 ExtractRandomMatch 属性是在执行 yield return Request1; 语句后设置的。
namespace TestProject1
{
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.VisualStudio.TestTools.WebTesting;
using Microsoft.VisualStudio.TestTools.WebTesting.Rules;
public class ExtractRandomExampleCoded : WebTest
{
public ExtractRandomExampleCoded()
{
this.PreAuthenticate = true;
}
public override IEnumerator<WebTestRequest> GetRequestEnumerator()
{
// Initialize validation rules that apply to all requests in the WebTest
if ((this.Context.ValidationLevel >= Microsoft.VisualStudio.TestTools.WebTesting.ValidationLevel.Low))
{
ValidateResponseUrl validationRule1 = new ValidateResponseUrl();
this.ValidateResponse += new EventHandler<ValidationEventArgs>(validationRule1.Validate);
}
WebTestRequest request1 = new WebTestRequest("https://vsncts01/testwebsite");
request1.ThinkTime = 9;
request1.ExpectedResponseUrl = "https://vsncts01/testwebsite/";
ExtractText extractionRule1 = new ExtractText();
extractionRule1.StartsWith = "href=\"";
extractionRule1.EndsWith = "\"";
extractionRule1.IgnoreCase = false;
extractionRule1.UseRegularExpression = false;
extractionRule1.Required = true;
extractionRule1.ExtractRandomMatch = true;
extractionRule1.Index = 0;
extractionRule1.HtmlDecode = true;
extractionRule1.ContextParameterName = "href";
request1.ExtractValues += new EventHandler<ExtractionEventArgs>(extractionRule1.Extract);
yield return request1;
request1 = null;
}
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。