Komponententest von Visual C#-Code in einer Windows Store-App

In diesem Thema wird beschrieben, wie Sie mithilfe von Visual Studio Express 2012 für Windows 8 und dem Microsoft-Komponententest-Framework Komponententests für eine Visual C#-Klasse in einer Windows Store-App erstellen. Die Klasse "Rooter" implementiert eine Funktion zum näherungsweisen Berechnen der Quadratwurzel einer vorgegebenen Zahl, und zwar in einer Weise, die entfernt an Grenzwertberechnungen in der Analysis erinnert. Von der Mathematik-App kann diese Funktion dann verwendet werden, um Benutzern zu zeigen, wie interessant und unterhaltsam Mathematik sein kann.

In diesem Thema wird gezeigt, wie Komponententests als erster Schritt in der Entwicklung verwendet werden. Bei dieser Vorgehensweise schreiben Sie zuerst eine Testmethode, die ein bestimmtes Verhalten in Ihrem Testsystem überprüft. Anschließend schreiben Sie den Code, der im Test erfolgreich ist. Durch das Ändern der Reihenfolge bei den folgenden Prozeduren, können Sie diese Strategie umkehren und zuerst den zu testenden Code und anschließend die Komponententests schreiben.

In diesem Thema werden auch eine einzelne Visual Studio-Projektmappe und separate Projekte für die zu testenden Komponententests und DLLs erstellt. Sie können die Komponententests auch direkt in das DLL-Projekt einfügen, oder Sie können separate Lösungen für die Komponententests und die DLL erstellen.

In diesem Thema

Erstellen Sie die Projektmappe und das Komponententestprojekt.

Stellen Sie sicher, dass die Tests im Test-Explorer ausgeführt werden.

Fügen Sie die Klasse "Rooter" zu dem Projekt "Mathematik" hinzu.

Verknüpfen Sie das Testprojekt mit dem App-Projekt.

Steigern Sie die Tests iterativ, und schließen Sie sie erfolgreich ab.

Debuggen Sie einen fehlgeschlagenen Test.

Gestalten Sie den Code um.

Erstellen Sie die Projektmappe und das Komponententestprojekt.

1. Wählen Sie im Menü Datei die Option Neu aus, und klicken Sie dann auf Neues Projekt.

2. Erweitern Sie im Dialogfeld Neues Projekt den Eintrag Installiert, erweitern Sie Visual C#, und wählen Sie Windows Store aus. Wählen Sie dann in der Liste der Projektvorlagen Leere App aus.

3. Nennen Sie das Projekt Mathematik, und stellen Sie sicher, dass Projektmappenverzeichnis erstellen ausgewählt ist.

4. Wählen Sie im Projektmappen-Explorer den Projektmappenname aus. Wählen Sie anschließend aus dem Kontextmenü Hinzufügen und dann Neues Projekt aus.

5. Erweitern Sie im Dialogfeld Neues Projekt den Eintrag Installiert, erweitern Sie Visual C#, und wählen Sie Windows Store aus. Wählen Sie dann Komponententestbibliothek (Windows Store-Apps) aus der Liste der Projektvorlagen aus.

   

6. Öffnen Sie UnitTest1.cs im Visual Studio-Editor.

   using System;
   using System.Collections.Generic;
   using System.Linq;
   using System.Text;
   using Microsoft.VisualStudio.TestPlatform.UnitTestFramework;
   using Maths;
   
   namespace RooterTests
   {
       [TestClass]
       public class UnitTest1
   
           [TestMethod]
           public void TestMethod1()
           {
   
           }
   

   Hinweis:

   1. Jeder Test wird durch die [TestMethod]-Verwendung definiert. Eine Testmethode muss den Wert "void" zurückgeben und darf keine Parameter haben.

   2. Testmethoden müssen in einer Klasse enthalten sein, die durch das [TestClass]-Attribut ergänzt wird.

      Wenn die Tests ausgeführt werden, wird eine Instanz jeder Testklasse erstellt. Die Testmethoden werden in einer nicht angegebenen Reihenfolge aufgerufen.

   3. Sie können spezielle Methoden definieren, die vor und nach jedem Modul, jeder Klasse oder Methode aufgerufen werden. Weitere Informationen finden Sie unter Verwenden von Microsoft.VisualStudio.TestTools.UnitTesting-Membern in Komponententests in der MSDN Library.

Stellen Sie sicher, dass die Tests im Test-Explorer ausgeführt werden.

1. Fügen Sie einen Testcode in TestMethod1 der UnitTest1.cs-Datei ein:

   [TestMethod]
   public void TestMethod1()
   {
       Assert.AreEqual(0, 0);
   }
   

   Die Assert-Klasse stellt mehrere statische Methoden bereit, um die Ergebnisse in den Testmethoden zu überprüfen.

2. Wählen Sie im Menü Test die Option Ausführen und dann Alle ausführen aus.

   Das Testprojekt wird erstellt und ausgeführt. Das Test-Explorer-Fenster wird angezeigt, und der Test wird unter Bestandene Tests aufgeführt. Unten im Fenster im Bereich "Zusammenfassung" werden weitere Informationen über den ausgewählten Test angezeigt.

   

Fügen Sie die Klasse "Rooter" zu dem Projekt "Mathematik" hinzu.

1. Wählen Sie im Projektmappen-Explorer den Projektname Mathematik. Wählen Sie im Kontextmenü Hinzufügen und dann Klasse aus.

2. Nennen Sie die Klassendatei Rooter.cs

3. Fügen Sie der Rooter-Klassendatei Rooter.cs den folgenden Code hinzu:

       public Rooter()
       {
       }
   
       // estimate the square root of a number
       public double SquareRoot(double x)
       {
           return 0.0;
       }
   
   
   

   Die Rooter-Klasse deklariert einen Konstruktor und die SqareRoot-Abschätzermethode.

4. Die SqareRoot-Methode ist nur eine minimale Implementierung, die gerade ausreicht, um die Grundstruktur des Testsetups zu testen.

Verknüpfen Sie das Testprojekt mit dem App-Projekt.

1. Fügen Sie dem RooterTests-Projekt einen Verweis auf die Mathematik-App hinzu.

   1. Wählen Sie im Projektmappen-Explorer das Projekt RooterTests aus, und wählen Sie dann im Kontextmenü die Option Verweis hinzufügen aus.

   2. Erweitern Sie im Dialogfeld Verweis hinzufügen - RooterTests den Eintrag Projektmappe und wählen Sie Projekte aus. Wählen Sie dann das Element Mathematik aus.

      

2. Fügen Sie der Datei "UnitTest1.cs" eine using-Anweisung hinzu:

   1. Öffnen Sie UnitTest1.cs.

   2. Fügen Sie diesen Code unter der Zeile using Microsoft.VisualStudio.TestPlatform.UnitTestFramework; hinzu:

      using Maths;
      

3. Fügen Sie einen Test hinzu, der die Funktion "Rooter" verwendet. Fügen Sie den folgenden Code zu UnitTest1.cpp hinzu:

       [TestMethod]
       public void BasicTest()
       {
           Maths.Rooter rooter = new Rooter();
           double expected = 0.0;
           double actual = rooter.SquareRoot(expected * expected);
           double tolerance = .001;
           Assert.AreEqual(expected, actual, tolerance);
       }
   

4. Erstellen Sie die Projektmappe.

   Der neue Test wird im Test-Explorer im Knoten Nicht ausgeführte Tests angezeigt.

5. Wählen Sie im Test-Explorer die Option Alle ausführen aus.

   

Sie haben den Test und die Codeprojekte eingerichtet und überprüft, dass Sie Tests ausführen können, die Funktionen im Codeprojekt ausführen. Sie können jetzt damit beginnen, echte Tests und Code zu schreiben.

Steigern Sie die Tests iterativ, und schließen Sie sie erfolgreich ab.

1. Fügen Sie einen neuen Test hinzu:

       [TestMethod]
       public void RangeTest()
       {
           Rooter rooter = new Rooter();
           for (double v = 1e-6; v < 1e6; v = v * 3.2)
           {
               double expected = v;
               double actual = rooter.SquareRoot(v*v);
               double tolerance = ToleranceHelper(expected);
               Assert.AreEqual(expected, actual, tolerance);
           }
       }
   

   Tipp

   Es wird empfohlen, dass Sie keine Tests ändern, die erfolgreich abgeschlossen wurden. Fügen Sie stattdessen einen neuen Test hinzu, aktualisieren Sie den Code, sodass der Test erfolgreich ist, und fügen Sie dann einen anderen Test hinzu. Fahren Sie auf diese Weise fort.

   Wenn die Benutzer ihre Anforderungen ändern, deaktivieren Sie die Tests, die nicht mehr richtig sind. Schreiben Sie neue Tests, und lassen Sie sie auf die gleiche stufenweise Art arbeiten.

2. Wählen Sie im Test-Explorer die Option Alle ausführen aus.

3. Der Test schlägt fehl.

   

   Tipp

   Überprüfen Sie unmittelbar nach dem Schreiben eines Tests, dass er fehlschlägt. Damit vermeiden Sie den einfachen Fehler, einen Test zu schreiben, der nie fehlschlägt.

4. Erweitern Sie den Code unter dem Test, damit der neue Test erfolgreich ist. Ändern Sie die SqareRoot-Funktion in Rooter.cs in:

       public double SquareRoot(double x)
       {
           double estimate = x;
           double diff = x;
           while (diff > estimate / 1000)
           {
               double previousEstimate = estimate;
               estimate = estimate - (estimate * estimate - x) / (2 * estimate);
               diff = Math.Abs(previousEstimate - estimate);
           }
           return estimate;
       }
   

5. Erstellen Sie die Projektmappe, und wählen Sie dann im Test-Explorer Alle ausführen aus.

   Alle drei Tests sind jetzt erfolgreich.

Debuggen Sie einen fehlgeschlagenen Test.

1. Fügen Sie einen anderen Test zu UnitTest1.cs hinzu:

       // Verify that negative inputs throw an exception.
       [TestMethod]
       public void NegativeRangeTest()
       {
           string message;
           Rooter rooter = new Rooter();
           for (double v = -0.1; v > -3.0; v = v - 0.5)
           {
               try
               {
                   // Should raise an exception:
                   double actual = rooter.SquareRoot(v);
   
                   message = String.Format("No exception for input {0}", v);
                   Assert.Fail(message);
               }
               catch (ArgumentOutOfRangeException ex)
               {
                   continue; // Correct exception.
               }
               catch (Exception e)
               {
                   message = String.Format("Incorrect exception for {0}", v);
                   Assert.Fail(message);
               }
           }
       }
   

2. Wählen Sie im Test-Explorer die Option Alle ausführen aus.

   Der Test schlägt fehl. Wählen Sie den Testnamen im Test-Explorer aus. Der Assertionsfehler wird hervorgehoben. Die Fehlermeldung wird im Detailbereich des Test-Explorers angezeigt.

   

3. Gehen Sie die Funktion durch, um herauszufinden, weshalb der Test fehlschlägt:

   1. Legen Sie einen Haltepunkt am Anfang der SquareRoot-Funktion fest.

   2. Wählen Sie im Kontextmenü des fehlgeschlagenen Tests die Option Ausgewählte Tests debuggen aus.

      Wenn die Ausführung am Haltepunkt beendet wird, gehen Sie den Code schrittweise durch.

   3. Fügen Sie Code zur Rooter-Methode hinzu, um die Ausnahme zu erfassen:

          public double SquareRoot(double x)
          {
              if (x < 0.0)
              {
                  throw new ArgumentOutOfRangeException();
          }
      

   1. Wählen Sie im Test-Explorer Alle ausführen aus, um die korrigierte Methode zu testen und zu überprüfen, dass Sie keine Regression eingeführt haben.

Alle Tests sind jetzt erfolgreich.

Gestalten Sie den Code um.

Vereinfachen Sie die zentrale Berechnung in der SquareRoot-Funktion.

1. Ändern Sie die Ergebnisimplementierung.

   // old code
   //result = result - (result*result - v)/(2*result);
   // new code
   result = (result + v/result) / 2.0;
   

2. Wählen Sie Alle ausführen aus, um die umgestaltete Methode zu testen und zu überprüfen, dass Sie keine Regression eingeführt haben.

Gestalten Sie den Testcode um, um doppelten Code zu vermeiden.

Die RangeTest-Methode weist dem Nenner der Toleranzvariablen, die in der Assert-Methode verwendet wird, vordefinierten Code zu. Wenn Sie zusätzliche Tests hinzufügen möchten, in denen die gleiche Toleranzberechnung zur Anwendung kommt, können Fehler auftreten, wenn ein vordefinierter Wert an mehreren Speicherorten verwendet wird.

1. Fügen Sie eine private Methode zur Unit1Test-Klasse hinzu, um den Toleranzwert zu berechnen und anschließend stattdessen diese Methode aufzurufen.

       private double ToleranceHelper(double expected)
       {
           return expected / 1000;
       }
   
       ...
   
       [TestMethod]
       public void RangeTest()
       {
           ...
           // old code
           // double tolerance = expected/1000;
           // new code
           double tolerance = ToleranceHelper(expected);
           Assert.AreEqual(expected, actual, tolerance);
       }
       ...
   

2. Wählen Sie Alle ausführen aus, um die umgestaltete Methode zu testen und zu überprüfen, dass Sie keinen Fehler eingeführt haben.