HOW TO：建立負載測試外掛程式

發行項
02/28/2013

您可以建立負載測試外掛程式，以便在執行負載測試的不同時刻執行。您可以建立外掛程式，以擴充或修改負載測試的內建功能。例如，您可以撰寫負載測試外掛程式，以便在執行負載測試時，設定或修改負載測試模式。若要這麼做，就必須建立繼承自 ILoadTestPlugin 介面的類別。這個類別必須實作此介面的 Initialize 方法。如需詳細資訊，請參閱ILoadTestPlugin。

注意事項
您也可以建立 Web 效能測試的外掛程式。如需詳細資訊，請參閱HOW TO：建立 Web 效能測試外掛程式。

需求

Visual Studio Ultimate

若要使用 Visual C# 建立負載測試外掛程式

開啟包含Web效能測試的Web效能和負載測試專案

如需詳細資訊，請參閱HOW TO：建立和設定自動化測試的測試專案。
將負載測試加入至測試專案，並將它設定為執行 Web 效能測試。

如需詳細資訊，請參閱使用新增負載測試精靈建立負載測試。
在方案管理員中，在方案上按右鍵並選加入然後再選新專案。

[加入新的專案] 對話方塊隨即出現。
在 [已安裝的範本] 底下，選取 [Visual C#]。
在範本清單中，選取 [類別庫]。
在 [名稱] 文字方塊中，輸入類別的名稱。
選擇 [確定]。
新的類別庫專案會加入至 [方案總管]，而且新的類別會出現在 [程式碼編輯器] 中。
在 [方案總管] 中，以滑鼠右鍵按一下新類別庫中的 [參考] 資料夾，然後選取 [加入參考]。
接著會顯示 [加入參考] 對話方塊。
選擇**.NET標籤，往下拉，並選Microsoft.VisualStudio.QualityTools.LoadTestFramework**.
選擇 [確定]。

[Microsoft.VisualStudio.QualityTools.LoadTestFramework] 的參考就會加入至 [方案總管] 中的 [參考] 資料夾。
在方案管理員中，在最上面的Web效能和負載測試專案節點上按右鍵(包含你所要加入到負載測試插件的測試)，然後選擇Add Reference。
[加入參考] 對話方塊隨即顯示。
選擇Projects標籤然後選類別資料庫專案。
選擇 [確定]。
在 [程式碼編輯器] 中，加入 Microsoft.VisualStudio.TestTools.LoadTesting 命名空間的 using 陳述式。
實作在類別庫專案中所建立之類別的 ILoadTestPlugin 介面。如需範例實作，請參閱下列的＜範例＞一節。
程式碼撰寫完成之後，請建置新專案。
右鍵點擊上方的負載測試節點然後選加入負載測試插件。

[加入負載測試外掛程式] 對話方塊隨即出現。
在 [選取外掛程式] 底下，選取您的負載測試外掛程式類別。

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

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

選擇 [確定]。

此外掛程式就會加入至 [負載測試外掛程式] 資料夾。
警告

當您執行使用外掛程式的 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. 在您的 Web 效能測試和負載測試專案中，您將會看到參考中的警告。移除並重新加入外掛程式 DLL 的參考。
2. 從測試或適當的位置中移除外掛程式，然後再重新加入。

範例

下列程式碼會顯示在 LoadTestFinished 事件發生後，執行自訂程式碼的負載測試外掛程式。如果這段程式碼是在遠端電腦的測試代理程式上執行，而且測試代理程式沒有 localhost SMTP 服務，負載測試就會維持在「進行中」的狀態，因為系統將會開啟訊息方塊。

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

using System;
using Microsoft.VisualStudio.TestTools.LoadTesting;
using System.Net.Mail;
using System.Windows.Forms;

namespace LoadTestPluginTest
{
    public class MyLoadTestPlugin : ILoadTestPlugin
    {
        LoadTest myLoadTest;

        public void Initialize(LoadTest loadTest)
        {
            myLoadTest = loadTest;
            myLoadTest.LoadTestFinished += new
                EventHandler(myLoadTest_LoadTestFinished);
        }

        void myLoadTest_LoadTestFinished(object sender, EventArgs e)
        {
            try
            {
                // place custom code here
                MailAddress MyAddress = new MailAddress("someone@example.com");
                MailMessage MyMail = new MailMessage(MyAddress, MyAddress);
                MyMail.Subject = "Load Test Finished -- Admin Email";
                MyMail.Body = myLoadTest..Name + " has finished.";

                SmtpClient MySmtpClient = new SmtpClient("localhost");
                MySmtpClient.Send(MyMail);
            }

            catch (SmtpException ex)
            {
                MessageBox.Show(ex.InnerException.Message +
                    ".\r\nMake sure you have a valid SMTP.", "LoadTestPlugin", MessageBoxButtons.OK, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button1);
            }
        }
    }
}

有八個事件與負載測試相關聯，而且負載測試外掛程式可以處理這些事件，以便搭配負載測試執行自訂程式碼。下面是一份事件清單，這些事件可讓您存取負載測試回合的不同期間：

請參閱

共用方式為

HOW TO：建立負載測試外掛程式

若要使用 Visual C# 建立負載測試外掛程式

範例

請參閱

工作

參考

其他資源

其他資源