Freigeben über

Erstellen eines datengesteuerten Komponententests

  • Artikel

Sie können das Komponententestframework von Microsoft (MSTest) für verwaltenden Code verwenden, um eine Komponententestmethode zu erstellen, die Werte aus einer Datenquelle abruft. Die Methode wird nacheinander für jede Zeile in der Datenquelle ausgeführt, die mithilfe einer einzelnen Methode das Testen von einer Vielzahl von Eingaben vereinfacht.

Ein datengesteuerter Komponententest kann Folgendes verwenden:

  • Inlinedaten mithilfe des DataRow-Attributs
  • Memberdaten mithilfe des DynamicData-Attributs
  • Daten von einigen bekannten Quellanbietern mithilfe des DataSource-Attributs

Die zu testende Methode

Nehmen wir zum Beispiel an, dass Sie über Folgendes verfügen:

  1. Eine Lösung mit dem Namen MyBank, die Transaktionen für verschiedene Kontenarten akzeptiert und verarbeitet.

  2. Ein Projekt mit dem Namen BankDb in MyBank, das die Transaktionen für Konten verwaltet.

  3. Eine Klasse mit dem Namen Maths im Projekt BankDb, die die mathematische Funktionen ausführt, um sicherzustellen, dass jede Transaktion für die Bank vorteilhaft ist.

  4. Ein Komponententestprojekt mit dem Namen BankDbTests, um das Verhalten der Komponente BankDb zu testen.

  5. Eine Komponentententestklasse mit dem Namen MathsTests, um das Verhalten von Klasse Maths zu testen.

Wir testen in Maths eine Methode, die mithilfe einer Schleife zwei ganze Zahlen hinzufügt:

public int AddIntegers(int first, int second)
{
    int sum = first;
    for (int i = 0; i < second; i++)
    {
        sum += 1;
    }

    return sum;
}

Testmethode

Durch Inlinedaten gesteuerter Test

Für Inlinetests verwendet MSTest DataRow, um Werte anzugeben, die vom datengesteuerten Test verwendet werden. Der Test in diesem Beispiel wird für jede Datenzeile nacheinander ausgeführt.

[TestMethod]
[DataRow(1, 1, 2)]
[DataRow(2, 2, 4)]
[DataRow(3, 3, 6)]
[DataRow(0, 0, 1)] // The test run with this row fails
public void AddIntegers_FromDataRowTest(int x, int y, int expected)
{
    var target = new Maths();
    int actual = target.AddIntegers(x, y);
    Assert.AreEqual(expected, actual,
        "x:<{0}> y:<{1}>",
        new object[] {x, y});
}

Durch Memberdaten gesteuerter Test

MSTest verwendet das DynamicData-Attribut, um den Namen, die Art (Eigenschaft, Standardwert oder Methode) und den definierenden Typ (standardmäßig wird der aktuelle Typ verwendet) des Members anzugeben, das die vom datengesteuerten Test verwendeten Daten bereitstellt.

public static IEnumerable<object[]> AdditionData
{
    get
    {
        return new[]
        { 
            new object[] { 1, 1, 2 },
            new object[] { 2, 2, 4 },
            new object[] { 3, 3, 6 },
            new object[] { 0, 0, 1 }, // The test run with this row fails
        };
    }
}

[TestMethod]
[DynamicData(nameof(AdditionData))]
public void AddIntegers_FromDynamicDataTest(int x, int y, int expected)
{
    var target = new Maths();
    int actual = target.AddIntegers(x, y);
    Assert.AreEqual(expected, actual,
        "x:<{0}> y:<{1}>",
        new object[] {x, y});
}

Es ist auch möglich, den standardmäßig generierten Anzeigenamen mithilfe der DynamicDataDisplayName-Eigenschaft des DynamicData-Attributs außer Kraft zu setzen. Die Methodesignatur des Anzeigenamens muss public static string sein und zwei Parameter akzeptieren. Der erste Parameter ist vom Typ MethodInfo und der zweite vom Typ object[].

public static string GetCustomDynamicDataDisplayName(MethodInfo methodInfo, object[] data)
{
    return string.Format("DynamicDataTestMethod {0} with {1} parameters", methodInfo.Name, data.Length);
}

[DynamicData(nameof(AdditionData), DynamicDataDisplayName = nameof(GetCustomDynamicDataDisplayName))]

Datengesteuerter Quellanbietertest

Das Erstellen eines datengesteuerten Komponententests umfasst die folgenden Schritte:

  1. Erstellen Sie eine Datenquelle, die die Werte enthält, die Sie in der Testmethode verwenden. Die Datenquelle kann jeder Typ sein, der auf dem Computer registriert ist, auf dem der Test ausgeführt wird.

  2. Fügen Sie der Testklasse eine öffentliche TestContext-Eigenschaft vom Typ TestContext hinzu.

  3. Erstellen einer Komponententestmethode

  4. Fügen Sie ihr ein DataSourceAttribute-Attribut hinzu.

  5. Verwenden Sie die DataRow-Indexereigenschaft, um die Werte abzurufen, die Sie in einem Test verwenden.

Erstellen einer Datenquelle

Erstellen Sie zum Testen der Methode AddIntegers eine Datenquelle, die einen Wertebereich für die Parameter und die Summe angibt, die zurückgegeben werden soll. In diesem Beispiel wird eine SQL Compact-Datenbank mit dem Namen MathsData und eine Tabelle mit dem Namen AddIntegersData erstellt, die die folgenden Spaltennamen und -werte enthält:

FirstNumber SecondNumber Sum
0 1 1
1 1 2
2 -3 -1

Hinzufügen eines TestContext zur Testklasse

Das Komponententestframework erstellt ein Objekt TestContext, um die Informationen der Datenquelle für einen datengesteuerten Test zu speichern. Im Framework wird anschließend dieses Objekt als Wert für die von Ihnen erstellte Eigenschaft TestContext festgelegt.

public TestContext TestContext { get; set; }

In Ihrer Testmethode greifen Sie auf die Daten durch die Indexereigenschaft DataRow des TestContext zu.

Hinweis

.NET Core unterstützt das DataSource-Attribut nicht. Wenn Sie versuchen, in einem .NET Core-, UWP- oder WinUI-Komponententestprojekt in dieser Weise auf Testdaten zuzugreifen, wird ein Fehler in der Art von 'TestContext' enthält keine Definition für 'DataRow', und es konnte keine zugängliche Erweiterungsmethode 'DataRow' gefunden werden, die ein erstes Argument vom Typ 'TestContext' akzeptiert (fehlt möglicherweise eine using-Anweisung oder ein Assemblyverweis?)

Schreiben der Testmethode

Die Testmethode für AddIntegers ist recht einfach. Rufen Sie für jede Zeile in der Datenquelle AddIntegers mit den Spaltenwerten FirstNumber und SecondNumber als Parameter auf, und vergleichen Sie den Rückgabewert mit dem Spaltenwert Summe:

[TestMethod]
[DataSource(@"Provider=Microsoft.SqlServerCe.Client.4.0; Data Source=C:\Data\MathsData.sdf;", "Numbers")]
public void AddIntegers_FromDataSourceTest()
{
    var target = new Maths();

    // Access the data
    int x = Convert.ToInt32(TestContext.DataRow["FirstNumber"]);
    int y = Convert.ToInt32(TestContext.DataRow["SecondNumber"]);
    int expected = Convert.ToInt32(TestContext.DataRow["Sum"]);
    int actual = target.AddIntegers(x, y);
    Assert.AreEqual(expected, actual,
        "x:<{0}> y:<{1}>",
        new object[] {x, y});
}

Angeben des DataSourceAttribute

Das Attribut DataSource gibt die Verbindungszeichenfolge für die Datenquelle den Tabellennamen an, die Sie in der Testmethode verwenden. Die genaue Information in der Verbindungszeichenfolge ist unterschiedlich, je nachdem welche Datenquelle Sie verwenden. In diesem Beispiel wurde eine Datenbank „SqlServerCe“ verwendet.

[DataSource(@"Provider=Microsoft.SqlServerCe.Client.4.0;Data Source=C:\Data\MathsData.sdf", "AddIntegersData")]

Achtung

Die Verbindungszeichenfolge kann vertrauliche Daten (z. B. ein Kennwort) enthalten. Die Verbindungszeichenfolge wird im Nur-Text-Quellcode und in der kompilierten Assembly gespeichert. Beschränken Sie den Zugriff auf den Quellcode und die Assembly, um diese vertraulichen Informationen zu schützen.

Das DataSource-Attribut hat drei Konstruktoren.

[DataSource(dataSourceSettingName)]

Ein Konstruktor mit einem Parameter verwendet die Verbindungsinformationen, die in der app.config-Datei für die Projektmappe gespeichert sind. dataSourceSettingsName ist der Name des XML-Elements in der Config-Datei, das die Verbindungsinformationen angibt.

Eine app.config-Datei hilft Ihnen dabei, den Speicherort der Datenquelle zu ändern, ohne den Komponententest selbst zu ändern. Weitere Informationen zum Erstellen und Verwenden einer app.config-Datei finden Sie unter Exemplarische Vorgehensweise: Verwenden einer Konfigurationsdatei zum Definieren einer Datenquelle.

[DataSource(connectionString, tableName)]

Der Konstruktor DataSource mit zwei Parametern gibt die Verbindungszeichenfolge für die Datenquelle und den Tabellennamen an, die die Daten für die Testmethode enthält.

Die Verbindungszeichenfolgen hängen vom Typ der Datenquelle ab, er sollte jedoch ein Anbieterelement enthalten, das den unveränderlichen Namen des Datenanbieters angibt.

[DataSource(
    dataProvider,
    connectionString,
    tableName,
    dataAccessMethod
    )]

Verwenden von TestContext.DataRow für den Zugriff auf die Daten

Verwenden Sie den Indexer AddIntegersData, um auf die Daten in der Tabelle TestContext.DataRow zuzugreifen. DataRow ist ein DataRow-Objekt. Dadurch werden Spaltenwerte anhand des Index oder der Spaltennamen abgerufen. Da die Werte als Objekte zurückgegeben werden, konvertieren Sie sie in den entsprechenden Typ:

int x = Convert.ToInt32(TestContext.DataRow["FirstNumber"]);

Ausführen des Tests und Anzeigen von Ergebnissen

Wenn Sie mit dem Schreiben der Testmethode fertig sind, erstellen Sie das Testprojekt. Die Testmethode wird im Test-Explorer in der Gruppe Nicht ausgeführte Tests angezeigt. Beim Ausführen, Schreiben und erneuten Ausführen Ihrer Tests werden die Ergebnisse vom Test-Explorer in den Gruppen Fehlgeschlagene Tests, Bestandene Tests und Nicht ausgeführte Tests angezeigt. Sie können zum Ausführen aller Tests Alle ausführen auswählen. Sie können auch Ausführen auswählen, um eine Teilmenge der Tests auszuführen.

Während Ihr Test ausgeführt wird, wird die Testergebnisleiste im oberen Bereich des Test-Explorers animiert. Am Ende des Testlaufs wird die Leiste grün, wenn alle Tests erfolgreich waren, oder rot, wenn einer der Tests fehlgeschlagen ist. Im Detailbereich unten im Fenster des Test-Explorers wird eine Zusammenfassung des Testlaufs angezeigt. Wählen Sie einen Test aus, um die Details dieses Tests im unteren Bereich anzuzeigen.

Hinweis

Es gibt ein Ergebnis für jede Zeile mit Daten sowie ein zusammengefasstes Ergebnis. Wenn alle Zeilen den Test bestehen, gibt die Zusammenfassung das Ergebnis Bestanden zurück. Wenn eine beliebige Zeile den Test nicht besteht, gibt die Zusammenfassung das Ergebnis Fehlgeschlagen zurück.

Wenn Sie die AddIntegers_FromDataRowTest-, AddIntegers_FromDynamicDataTest- oder AddIntegers_FromDataSourceTest-Methode in unserem Beispiel ausgeführt haben, wird die Ergebnisleiste rot, und die Testmethode wird in die Gruppe Fehlgeschlagene Tests verschoben. Ein datengesteuerter Test schlägt fehl, wenn eine der durchlaufenen Methoden aus der Datenquelle fehlschlägt. Wenn Sie einen fehlgeschlagenen datengesteuerten Test im Fenster des Test-Explorers auswählen, wird im Detailbereich das Ergebnis von jedem Durchlauf angezeigt, der vom Datenzeilenindex identifiziert wird. Es scheint, dass in diesem Beispiel der Algorithmus AddIntegers negative Werte nicht richtig behandelt.

Wenn die zu testende Methode korrigiert und den Test erneut ausgeführt wird, wird die Ergebnisleiste grün, und die Testmethode wird in die Gruppe Bestandene Tests verschoben.

Zugehöriger Inhalt