WebTest 類別
所有 Web 效能測試的基底類別。 以 C# 撰寫的 Web 效能測試程式碼直接衍生自此類別。
繼承階層架構
System.Object
Microsoft.VisualStudio.TestTools.WebTesting.WebTest
Microsoft.VisualStudio.TestTools.WebTesting.DeclarativeWebTest
Microsoft.VisualStudio.TestTools.WebTesting.ThreadedWebTest
命名空間： Microsoft.VisualStudio.TestTools.WebTesting
組件： Microsoft.VisualStudio.QualityTools.WebTestFramework (在 Microsoft.VisualStudio.QualityTools.WebTestFramework.dll 中)
語法
'宣告
<SerializableAttribute> _
Public MustInherit Class WebTest _
Implements IEnumerable
[SerializableAttribute]
public abstract class WebTest : IEnumerable
[SerializableAttribute]
public ref class WebTest abstract : IEnumerable
[<AbstractClass>]
[<SerializableAttribute>]
type WebTest =
class
interface IEnumerable
end
public abstract class WebTest implements IEnumerable
WebTest 型別會公開下列成員。
建構函式
| 名稱 | 說明 | |
|---|---|---|
.gif "受保護的方法") |
WebTest | 初始化衍生自 WebTest 類別之類別的新執行個體。 |
回頁首
屬性
| 名稱 | 說明 | |
|---|---|---|
.gif "公用屬性") |
Context | 取得或設定物件，其中包含 Web 效能測試可在執行階段使用之內容變數。 |
|
DataSources | 取得為 Web 效能測試定義的資料來源集合。 |
|
Guid | 取得或設定 GUID，用以唯一辨識每個 WebTest 的執行個體。 |
|
InheritFromWebTest | 當這個 Web 效能測試包含在另一個 Web 效能測試中，並且從上層 Web 效能測試繼承屬性時，取得上層 Web 效能測試的 WebTest 物件。 |
|
LastRequestOutcome | |
|
LastResponse | 取得這個 Web 效能測試中所接收到的最後一個最上層要求回應。 |
|
Name | 取得測試案例的名稱。 |
|
Outcome | 取得或設定 Web 效能測試的「成功」或「失敗」結果。 |
|
Password | 取得和設定驗證時所使用的密碼。 |
|
PreAuthenticate | 取得或設定值，這個值表示是否要預先驗證 Web 效能測試內的所有要求。 |
|
Proxy | 取得或設定值，這個值表示 Web 效能測試要使用的 Proxy 伺服器。 |
|
RequestBodyCaptureLimit | 取得或設定擷取要求資料所用的限制 (以位元組為單位)。 |
|
ResponseBodyCaptureLimit | 取得或設定擷取回應資料所用的限制 (以位元組為單位)。 |
|
StopOnError | 取得或設定指示，這個指示表示測試是否應該在錯誤發生時停止執行。 |
|
UserName | 取得和設定驗證時所使用的使用者名稱。 |
|
ValidationRuleReferences | 取得 Web 效能測試層級驗證規則的參考集合。 |
|
WebProxy | 取得或設定這個 Web 效能測試所要使用的 Web Proxy。 |
|
WebTestPluginReferences | 取得 Web 效能測試外掛程式的參考集合。 |
回頁首
方法
.gif "公用方法")
回頁首
事件
| 名稱 | 說明 | |
|---|---|---|
.gif "公用事件") |
PostPage | |
|
PostRequest | 在這個 Web 效能測試執行的每個要求之後發生。 |
|
PostTransaction | |
|
PostWebTest | 在 Web 效能測試回合之後發生。 |
|
PrePage | |
|
PreRequest | 在這個 Web 效能測試執行的每個要求之前發生。 |
|
PreRequestDataBinding | |
|
PreTransaction | |
|
PreWebTest | 在 Web 效能測試回合之前發生。 |
|
ValidateResponse | 發生於接收到 Web 效能測試要求的回應並且準備進行驗證時。 |
|
ValidateResponseOnPageComplete |
回頁首
備註
若要使用 Visual Basic 2005 建立 Web 效能測試程式碼，請參閱 ThreadedWebTest。
如需 WebTest 類別之執行個體的初始屬性值清單，請參閱 WebTest 建構函式。
如需如何在 Visual Studio 2005 Team System 外執行測試的詳細資訊，請參閱從命令列執行自動化的測試。
此類別可以序列化。
繼承者注意事項
當您從 WebTest 繼承時，就必須覆寫 GetRequestEnumerator。
範例
下列 Web 效能測試會抽取表示核取方塊狀態的值，並將這些值加入內容中。
namespace TestProject1
{
using System;
using System.Collections.Generic;
using Microsoft.VisualStudio.TestTools.WebTesting;
using ClassLibrary2;
public class MyWebTest : WebTest
{
public MyWebTest()
{
this.PreAuthenticate = true;
}
public override IEnumerator<WebTestRequest> GetRequestEnumerator()
{
WebTestRequest request1 = new WebTestRequest("https://localhost/ts");
ExtractCheckBoxes rule1 = new ExtractCheckBoxes();
rule1.FindCheckedBoxes = true;
rule1.ContextParameterName = "CheckedBoxes";
request1.ExtractValues += new EventHandler
<ExtractionEventArgs>(rule1.Extract);
ExtractCheckBoxes rule2 = new ExtractCheckBoxes();
rule2.FindCheckedBoxes = false;
rule2.ContextParameterName = "";
request1.ExtractValues += new EventHandler
<ExtractionEventArgs>(rule2.Extract);
yield return request1;
}
}
}
執行緒安全
這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。
請參閱
參考
Microsoft.VisualStudio.TestTools.WebTesting 命名空間