Erstellen einer vollständigen .NET Core-Lösung unter Windows mit Visual Studio 2017Building a complete .NET Core solution on Windows, using Visual Studio 2017

Visual Studio 2017 bietet eine umfassende Entwicklungsumgebung für die Entwicklung von .NET Core-Anwendungen.Visual Studio 2017 provides a full-featured development environment for developing .NET Core applications. Die Verfahren in diesem Dokument beschreiben die erforderlichen Schritte zum Erstellen einer herkömmlichen .NET Core-Lösung, die wiederverwendbare Bibliotheken, Tests und das Verwenden von Bibliotheken von Drittanbietern vorsieht.The procedures in this document describe the steps necessary to build a typical .NET Core solution that includes reusable libraries, testing, and using third-party libraries.

Erforderliche KomponentenPrerequisites

Befolgen Sie die Anweisungen auf unserer Seite über erforderliche Komponenten, um Ihre Umgebung anzupassen.Follow the instructions on our prerequisites page to update your environment.

Eine Projektmappe nur mit .NET Core-ProjektenA solution using only .NET Core projects

Schreiben der BibliothekWriting the library

  1. Klicken Sie in Visual Studio auf Datei > Neu > Projekt.In Visual Studio, choose File, New, Project. In der neues Projekt Dialogfeld erweitern Sie die Visual C#- Knoten, und wählen Sie die .NET Standard Knoten, und wählen Sie dann -Klassenbibliothek (.NET Standard).In the New Project dialog, expand the Visual C# node and choose the .NET Standard node, and then choose Class Library (.NET Standard).

  2. Geben Sie dem Projekt den Namen „Library“ und der Projektmappe den Namen „Golden“.Name the project "Library" and the solution "Golden". Lassen Sie Projektmappenverzeichnis erstellen aktiviert.Leave Create directory for solution checked. Klicken Sie auf OK.Click OK.

  3. Öffnen Sie im Projektmappen-Explorer das Kontextmenü für den Knoten Abhängigkeiten, und wählen Sie NuGet-Pakete verwalten aus.In Solution Explorer, open the context menu for the Dependencies node and choose Manage NuGet Packages.

  4. Wählen Sie „nuget.org“ als Paketquelle aus, und klicken Sie auf die Registerkarte Durchsuchen. Suchen Sie nach Newtonsoft.Json.Choose "nuget.org" as the Package source, and choose the Browse tab. Browse for Newtonsoft.Json. Klicken Sie auf Installieren, und akzeptieren Sie die Lizenzbedingungen.Click Install, and accept the license agreement. Das Paket sollte jetzt unter Abhängigkeiten/NuGet angezeigt und automatisch wiederhergestellt werden.The package should now appear under Dependencies/NuGet and be automatically restored.

  5. Benennen Sie die Datei Class1.cs in Thing.cs um.Rename the Class1.cs file to Thing.cs. Akzeptieren Sie die Umbenennung der Klasse.Accept the rename of the class. Fügen Sie eine Methode hinzu: public int Get(int number) => Newtonsoft.Json.JsonConvert.DeserializeObject<int>($"{number}");Add a method: public int Get(int number) => Newtonsoft.Json.JsonConvert.DeserializeObject<int>($"{number}");

  6. Wählen Sie im Menü Erstellen die Option Projektmappe erstellen.On the Build menu, choose Build Solution.

    Die Projektmappe wird fehlerfrei erstellt.The solution should build without error.

Schreiben des TestprojektsWriting the test project

  1. Öffnen Sie in Projektmappen-Explorer das Kontextmenü des Knotens Projektmappe, und wählen Sie Hinzufügen > Neues Projekt aus.In Solution Explorer, open the context menu for the Solution node and choose Add, New Project. Wählen Sie im Dialogfeld Neues Projekt unter Visual C#/.NET Core die Option Komponententestprojekt (.NET Core) aus.In the New Project dialog, under Visual C# / .NET Core, choose Unit Test Project (.NET Core). Nennen Sie sie „Testbibliothek“, und klicken Sie auf „OK“.Name it "TestLibrary" and click OK.

  2. Öffnen Sie im Projekt Testbibliothek das Kontextmenü des Knotens Abhängigkeiten, und wählen Sie Verweis hinzufügen aus.In the TestLibrary project, open the context menu for the Dependencies node and choose Add Reference. Klicken Sie auf Projekte, überprüfen Sie das Projekt „Bibliothek“, und klicken Sie auf „OK“.Click Projects, then check the Library project and click OK. Dadurch wird einen Verweis auf die Bibliothek aus dem Testprojekt hinzugefügt.This adds a reference to your library from the test project.

  3. Benennen Sie die Datei UnitTest1.cs in LibraryTests.cs um, und übernehmen Sie die Klassenumbenennung.Rename the UnitTest1.cs file to LibraryTests.cs and accept the class rename. Fügen Sie oben in der Datei using Library; hinzu, und ersetzen Sie die TestMethod1-Methode durch den folgenden Code:Add using Library; to the top of the file, and replace the TestMethod1 method with the following code:

    [TestMethod]
    public void ThingGetsObjectValFromNumber()
    {
        Assert.AreEqual(42, new Thing().Get(42));
    }
    

    Sie sollten nun die Projektmappe erstellen können.You should now be able to build the solution.

  4. Wählen Sie im Menü Testen zunächst Windows und dann Test-Explorer aus, um das Test-Explorer-Fenster in Ihrem Arbeitsbereich zu öffnen.On the Test menu, choose Windows, Test Explorer in order to get the test explorer window into your workspace. Nach wenigen Sekunden sollte der Test ThingGetsObjectValFromNumber im Test-Explorer angezeigt werden.After a few seconds, the ThingGetsObjectValFromNumber test should appear in the test explorer. Wählen Sie Alle ausführen aus.Choose Run All.

    Der Test sollte erfolgreich verlaufen.The test should pass.

Schreiben der KonsolenanwendungWriting the console app

  1. Öffnen Sie im Projektmappen-Explorer das Kontextmenü für die Projektmappe, und fügen Sie ein neues Projekt des Typs Konsolen-App (.NET Core) hinzu.In Solution Explorer, open the context menu for the solution, and add a new Console App (.NET Core) project. Nennen Sie es „App“.Name it "App".

  2. Öffnen Sie im Projekt App das Kontextmenü des Knotens Abhängigkeiten, und wählen Sie Hinzufügen > Verweis aus.In the App project, open the context menu for the Dependencies node and choose Add, Reference.

  3. Aktivieren Sie im Dialogfeld Verweis-Manager die Option Bibliothek unter Projekte im Knoten Projektmappe, und klicken Sie auf OK.In the Reference Manager dialog, check Library under the Projects, Solution node, and then click OK

  4. Öffnen Sie das Kontextmenü für den Knoten App, und wählen Sie Als Startprojekt festlegen aus.Open the context menu for the App node and choose Set as StartUp Project. Dadurch wird sichergestellt, dass bei Drücken von F5 oder STRG+F5 die Konsolen-App gestartet wird.This ensures that hitting F5 or CTRL+F5 will start the console app.

  5. Öffnen Sie die Datei Program.cs, fügen Sie am Anfang der Datei eine using Library;-Anweisung und anschließend Console.WriteLine($"The answer is {new Thing().Get(42)}."); zur Main-Methode hinzu.Open the Program.cs file, add a using Library; directive to the top of the file, and then add Console.WriteLine($"The answer is {new Thing().Get(42)}."); to the Main method.

  6. Legen Sie am Ende der hinzugefügten Zeile einen Haltepunkt fest.Set a breakpoint after the line that you just added.

  7. Drücken Sie F5, um die Anwendung auszuführen.Press F5 to run the application..

    Die Anwendung sollte ohne Fehler erstellt werden, und Sie sollten beim Haltepunkt ankommen.The application should build without error, and should hit the breakpoint. Darüber hinaus sollten Sie prüfen können, ob die Ausgabe der Anwendung „42“ lautet.You should also be able to check that the application output "The answer is 42.".