建立資料驅動自動程式碼 UI 測試

發行項
11/25/2015

若要測試不同的情況，您可以使用不同的參數值，多次執行您的測試。資料驅動自動程式碼 UI 測試是方便進行這項作業的方法。您可以在資料來源中定義參數值，而且資料來源中的每個資料列都是自動程式碼 UI 測試的反覆項目。整體測試結果將會根據所有反覆項目的結果。例如，如果其中一個測試反覆項目失敗，則整體測試結果就是失敗。

需求

Visual Studio Ultimate, Visual Studio Premium

建立資料驅動自動程式碼 UI 測試

這個範例會建立在 Windows 計算機應用程式上執行的自動程式碼 UI 測試。它將兩個數字相加，並使用判斷提示來驗證總和是否正確。接下來，會編碼兩個數字的判斷提示和參數值使其成為資料驅動並儲存在逗號分隔值 (.csv) 檔案中。

步驟 1 - 建立自動程式碼 UI 測試

建立專案。
選擇錄製動作。
開啟計算機應用程式，並開始錄製測試。

加入 1 加 2，並暫停錄製器，然後產生測試方法。稍後，我們會將此使用者輸入的值取代為資料檔中的值。

產生測試方法

關閉測試產生器。此方法會加入至測試：

        [TestMethod]
        public void CodedUITestMethod1()
        {
            // To generate code for this test, select "Generate Code for Coded UI Test" from the shortcut menu and select one of the menu items.
            this.UIMap.AddNumbers();

        }

使用 AddNumbers() 方法，確認執行測試。將游標放在上面顯示的測試方法中，並開啟內容功能表，然後選擇 [執行測試]。(快速鍵：Ctrl + R、T)。

[測試總管] 視窗中會顯示測試結果，而測試結果顯示測試成功還是失敗。若要開啟 [測試總管] 視窗，請從 [測試] 功能表中選擇 [Windows]，然後選擇 [測試總管]。
因為資料來源也可以用於判斷提示參數值 (測試用來確認預期的值)；讓我們加入判斷提示來驗證兩個數字的總和是否正確。將游標放在上面顯示的測試方法中，並開啟內容功能表，然後依序選擇 [產生自動程式碼 UI 測試的程式碼] 和 [使用自動程式碼 UI 測試產生器]。

對應計算機中顯示總和的文字控制項。
加入判斷提示，以驗證總和的值是否正確。選擇值為 3 的 [顯示文字] 屬性，然後選擇 [加入判斷提示]。使用 AreEqual 比較子，並確認比較值為 3。

設定判斷提示之後，請重新從建立器產生程式碼。這會建立新的方法來進行驗證。

產生判斷提示方法

因為 ValidateSum 方法會驗證 AddNumbers 方法的結果，所以請將它移至程式碼區塊底端。

        public void CodedUITestMethod1()
        {

            // To generate code for this test, select "Generate Code for Coded UI Test" from the shortcut menu and select one of the menu items.
            this.UIMap.AddNumbers();
            this.UIMap.ValidateSum();

        }

使用 ValidateSum() 方法，確認測試執行。將游標放在上面顯示的測試方法中，並開啟內容功能表，然後選擇 [執行測試]。(快速鍵：Ctrl + R、T)。

目前，所有參數值在其方法中都會定義為常數。接下來，讓我們建立資料集，以將測試設為資料驅動。

步驟 2 - 建立資料集

將文字檔加入至名稱為 data.csv 的 dataDrivenSample 專案。
將下列資料填入.csv 檔案：

Num1

Num2

Sum

3

4

7

5

6

11

6

8

14

加入資料之後，該檔案應該會顯示如下：
務必使用正確的編碼來儲存 .csv 檔案。在 [檔案] 功能表上，選擇 [進階儲存選項]，然後選擇 [Unicode (UTF-8 無簽章) - 字碼頁 65001] 做為編碼。
.csv 檔案必須複製至輸出目錄，否則無法執行測試。使用 [屬性] 視窗來複製它。

現在，我們已經建立了資料集，讓我們將資料繫結至測試。

Num1	Num2	Sum
3	4	7
5	6	11
6	8	14

步驟 3 - 加入資料來源繫結

若要繫結資料來源，請在測試方法正上方的現有 DataSource 屬性內加入 [TestMethod] 屬性。

        [DataSource("Microsoft.VisualStudio.TestTools.DataSource.CSV", "|DataDirectory|\\data.csv", "data#csv", DataAccessMethod.Sequential), DeploymentItem("data.csv"), TestMethod]
        public void CodedUITestMethod1()
        {

            // To generate code for this test, select "Generate Code for Coded UI Test" from the shortcut menu and select one of the menu items.
            this.UIMap.AddNumbers();
            this.UIMap.ValidateSum();

        }

現在，您可以在這個測試方法中使用此資料來源。

提示
請參閱其他資料來源類型 (例如 XML、SQL Express 和 Excel) 使用範例的＜問與答＞小節中的資料來源屬性範例。

執行測試。

請注意，測試是透過三個反覆項目來執行。原因是所繫結的資料來源包含三個資料列。不過，您也會發現測試仍在使用常數參數值，而且每次會加入 1 + 2 (總和為 3)。

接下來，我們會將測試設定成使用資料來源檔案中的值。

步驟 4 - 使用自動程式碼 UI 測試中的資料

將 using Microsoft.VisualStudio.TestTools.UITesting.WinControls 加入至 CodedUITest.cs 檔案的頂端：

using System;
using System.Collections.Generic;
using System.Text.RegularExpressions;
using System.Windows.Input;
using System.Windows.Forms;
using System.Drawing;
using Microsoft.VisualStudio.TestTools.UITesting;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using Microsoft.VisualStudio.TestTools.UITest.Extension;
using Keyboard = Microsoft.VisualStudio.TestTools.UITesting.Keyboard;
using Microsoft.VisualStudio.TestTools.UITesting.WinControls;

在將套用資料來源中值的 TestContext.DataRow[] 方法中，加入 CodedUITestMethod1()。資料來源值會使用控制項 SearchProperties 來覆寫指派給 UIMap 控制項的常數：
```
        public void CodedUITestMethod1()
        {

            // To generate code for this test, select "Generate Code for Coded UI Test" from the shortcut menu and select one of the menu items.
            this.UIMap.UICalculatorWindow.UIItemWindow.UIItem1Button.SearchProperties[WinButton.PropertyNames.Name] = TestContext.DataRow["Num1"].ToString(); 
            this.UIMap.UICalculatorWindow.UIItemWindow21.UIItem2Button.SearchProperties[WinButton.PropertyNames.Name] = TestContext.DataRow["Num2"].ToString();
            this.UIMap.AddNumbers();
            this.UIMap.ValidateSumExpectedValues.UIItem2TextDisplayText = TestContext.DataRow["Sum"].ToString();
            this.UIMap.ValidateSum();

        }
```
若要了解要將資料編寫至其中的搜尋屬性，請使用 [自動程式碼 UI 測試編輯器]。
- 開啟 UIMap.uitest 檔案。
- 選擇 UI 動作，並觀察對應的 UI 控制項對應。請注意，對應如何對應至程式碼 (例如，this.UIMap.UICalculatorWindow.UIItemWindow.UIItem1Button)。
- 在 [屬性] 視窗中，開啟 [搜尋屬性]。搜尋屬性 [名稱] 值是程式碼中使用資料來源所操作的值。例如，會將每個資料列的第一欄中的值指派給 SearchProperties：UIItem1Button.SearchProperties[WinButton.PropertyNames.Name] = TestContext.DataRow["Num1"].ToString();。對於三個反覆項目，這項測試會依序將搜尋屬性的 [名稱] 值變更為3、5 和 6。
儲存組態。

步驟 5 - 執行資料驅動測試

重新執行測試，確認測試現在是資料驅動。

您應該會看到使用 .csv 檔案中的值透過三個反覆項目的測試回合。驗證也應該會運作，而且測試在 [測試總管] 中應該顯示為通過。

指引

如需其他資訊，請參閱使用 Visual Studio 2012 測試持續傳遞 – 第 2 章：單元測試：內部測試和使用 Visual Studio 2012 測試持續傳遞 – 第 5 章：自動化系統測試。

問與答

其他資料來源類型 (例如 SQL Express 或 XML) 的資料來源屬性為何？

您可以使用下表中的範例資料來源字串，方法是將它們複製至您的程式碼，並進行必要的自訂。

日期來源類型	資料來源屬性
CSV	`[DataSource("Microsoft.VisualStudio.TestTools.DataSource.CSV", "\|DataDirectory\|\\data.csv", "data#csv", DataAccessMethod.Sequential), DeploymentItem("data.csv"), TestMethod]`
Excel	`DataSource("System.Data.Odbc", "Dsn=ExcelFiles;Driver={Microsoft Excel Driver (*.xls)};dbq=\|DataDirectory\|\\Data.xls;defaultdir=.;driverid=790;maxbuffersize=2048;pagetimeout=5;readonly=true", "Sheet1$", DataAccessMethod.Sequential), DeploymentItem("Sheet1.xls"), TestMethod]`
Team Foundation Server 中的測試案例	`[DataSource("Microsoft.VisualStudio.TestTools.DataSource.TestCase", "http://vlm13261329:8080/tfs/DefaultCollection;Agile", "30", DataAccessMethod.Sequential), TestMethod]`
XML	`[DataSource("Microsoft.VisualStudio.TestTools.DataSource.XML", "\|DataDirectory\|\\data.xml", "Iterations", DataAccessMethod.Sequential), DeploymentItem("data.xml"), TestMethod]`
SQL Express	`[DataSource("System.Data.SqlClient", "Data Source=.\\sqlexpress;Initial Catalog=tempdb;Integrated Security=True", "Data", DataAccessMethod.Sequential), TestMethod]`

問：我是否可以在 Windows Phone 應用程式上使用資料驅動型測試？

**答：**可以。Windows Phone 的資料驅動型自動程式碼 UI 測試是透過測試方法上的 DataRow 屬性來定義。在下列範例中，x 和 y 針對測試的第一個反覆項目使用值 1 和 2，並針對第二個反覆項目使用 -1 和 -2。

[DataRow(1, 2, DisplayName = "Add positive numbers")]
[DataRow(-1, -2, DisplayName = "Add negative numbers")]
[TestMethod]
public void DataDrivingDemo_MyTestMethod(int x, int y)

如需詳細資訊，請參閱Use Data-driven coded UI tests on Windows Phone apps。

問：為什麼無法修改 UIMap.Designer 檔案中的程式碼？

**答：**每次使用 [UIMap - 自動程式碼 UI 測試產生器] 產生程式碼時，都會覆寫您在 UIMapDesigner.cs 檔案中進行的任何程式碼變更。在這個範例中，而且在大多數的情況下，可以對測試的原始程式碼檔案 (即 CodedUITest1.cs) 進行讓測試使用資料來源所需的程式碼變更。

如果您需要修改錄製的方法，必須將它複製到 UIMap.cs 檔案並重新命名。UIMap.cs 檔案可用來覆寫 UIMapDesigner.cs 檔案中的方法和屬性。您必須移除 Coded UITest.cs 檔案中原始方法的參考，並將它取代為重新命名的方法名稱。

請參閱

共用方式為

建立資料驅動自動程式碼 UI 測試

建立資料驅動自動程式碼 UI 測試

步驟 1 - 建立自動程式碼 UI 測試

步驟 2 - 建立資料集

步驟 3 - 加入資料來源繫結

步驟 4 - 使用自動程式碼 UI 測試中的資料

步驟 5 - 執行資料驅動測試

問與答

其他資料來源類型 (例如 SQL Express 或 XML) 的資料來源屬性為何？

問：我是否可以在 Windows Phone 應用程式上使用資料驅動型測試？

問：為什麼無法修改 UIMap.Designer 檔案中的程式碼？

請參閱

參考

概念

其他資源

其他資源