HOW TO：建立要求層級外掛程式

發行項
08/12/2011

這個主題適用於：

Visual Studio Ultimate	Visual Studio Premium	Visual Studio Professional	Visual Studio Express

「要求」(Request) 指構成 Web 效能測試的宣告式陳述式。 Web 效能測試外掛程式可以讓您在 Web 效能測試的主要宣告式陳述式之外找出及重複使用程式碼。您可以建立外掛程式，並將其加入到個別的要求中，也可以加入到包含要求的 Web 效能測試中。自訂的「要求外掛程式」(Request Plug-in) 提供您一種方式，可以在特別要求於 Web 效能測試中執行時呼叫程式碼。

每個 Web 效能測試要求外掛程式都有 PreRequest 方法和 PostRequest 方法。將要求外掛程式附加至特定 http 要求後，會在發出要求前引發 PreRequest 事件，並會在收到回應後引發 PostRequest。

您可以建立自訂的 Web 效能測試要求外掛程式，方法是從 WebTestRequestPlugin 基底類別中衍生自己的類別。

您可以使用自訂的 Web 效能測試要求外掛程式搭配您已經記錄的 Web 效能測試。自訂的 Web 效能測試要求外掛程式讓您可以撰寫極少量的程式碼，即可達成對 Web 效能測試的更高層級控制。但是，自訂的 Web 效能測試外掛程式也可以與 Web 效能測試程式碼搭配使用。如需詳細資訊，請參閱 HOW TO：建立 Web 效能測試程式碼。

若要建立要求層級外掛程式

在 [方案總管] 中，以滑鼠右鍵按一下方案，選取 [加入]，然後按一下 [新增專案]。

[加入新的專案] 對話方塊隨即出現。
在 [已安裝的範本] 底下，選取 [Visual C#]。
在範本清單中，選取 [類別庫]。
在 [名稱] 文字方塊中輸入類別名稱，然後按一下 [確定]。

新的類別庫專案會加入至 [方案總管]，而且新的類別會出現在 [程式碼編輯器] 中。
在 [方案總管] 中，以滑鼠右鍵按一下新類別庫中的 [參考] 資料夾，然後選取 [加入參考]。

接著會顯示 [加入參考] 對話方塊。
按一下 [.NET] 索引標籤並向下捲動，然後選取 [Microsoft.VisualStudio.QualityTools.WebTestFramework]，再按一下 [確定]。

[Microsoft.VisualStudio.QualityTools.WebTestFramework] 的參考就會加入至 [方案總管] 中的 [參考] 資料夾。
在 [方案總管] 中，以滑鼠右鍵按一下測試專案最上方的節點，其中包含要在其中加入 Web 效能測試要求測試外掛程式的負載測試。選取 [加入參考]。

[加入參考] 對話方塊隨即顯示。
按一下 [專案] 索引標籤，並選取 [類別庫專案]，然後按一下 [確定]。
在 [程式碼編輯器] 中，撰寫外掛程式的程式碼。首先，建立衍生自 WebTestRequestPlugin 的新公用類別。
在 PreRequest 和 PostRequest 這兩個事件處理常式的其中一個或同時在兩個內實作程式碼。如需範例實作，請參閱下列的＜範例＞一節。
程式碼撰寫完成之後，請建置新專案。
開啟您想加入要求外掛程式的 Web 效能測試。
以滑鼠右鍵按一下要在其中加入要求外掛程式的要求，然後選取 [加入要求外掛程式]。

[加入 Web 要求外掛程式] 對話方塊隨即出現。
在 [選取外掛程式] 底下，選取新的外掛程式。

在 [所選外掛程式的屬性] 窗格中，設定外掛程式要在執行階段中使用的初始值。

注意事項
您可以從外掛程式公開任意數目的屬性，只要讓這些屬性成為公用、可設定且屬於基底型別 (例如整數、布林或字串) 的屬性即可。您之後也可以使用 [屬性] 視窗來變更 Web 效能測試外掛程式屬性。

按一下 [確定]。

外掛程式就會加入至 [要求外掛程式] 資料夾，這是 HTTP 要求的子資料夾。
警告

當您執行使用外掛程式的 Web 效能測試或負載測試時，可能會收到類似下面的錯誤：

Request failed: Exception in <plug-in> event: Could not load file or assembly '<"Plug-in name".dll file>, Version=<n. n. n. n>, Culture=neutral, PublicKeyToken=null' or one of its dependencies. The system cannot find the file specified.

如果您對任何外掛程式進行程式碼變更並建立新的 DLL 版本 (Version=0.0.0.0)，但是外掛程式仍然參考原始的外掛程式版本，就會導致此錯誤發生。若要更正此問題，請依照下列步驟執行：
1. 在測試專案中，您將會在參考中看見警告。移除並重新加入外掛程式 DLL 的參考。
2. 從測試或適當的位置中移除外掛程式，然後再重新加入。

範例

您可以使用下列程式碼建立自訂的 Web 效能測試外掛程式，該外掛程式會顯示兩個對話方塊。一個對話方塊會顯示 URL，此 URL 與附加要求增益集的要求相關聯。另一個對話方塊則顯示代理程式的電腦名稱。

注意事項
下列程式碼會要求您加入 System.Windows.Forms 的參考。

using System;
using System.Collections.Generic;
using System.Windows.Forms;
using Microsoft.VisualStudio.TestTools.WebTesting;

namespace RequestPluginNamespace
{
    public class MyWebRequestPlugin : WebTestRequestPlugin
    {
        public override void PostRequest(object sender, PostRequestEventArgs e)
        {
            MessageBox.Show(e.WebTest.Context.AgentName);
        }
        public override void PreRequest(object sender, PreRequestEventArgs e)
        {
            MessageBox.Show(e.Request.Url);
        }
    }
}

請參閱

共用方式為

HOW TO：建立要求層級外掛程式

若要建立要求層級外掛程式

範例

請參閱

工作

參考

其他資源

其他資源