Erstellen einer .NET Standard-Klassenbibliothek mit C# und .NET Core SDK in Visual Studio 2017Build a .NET Standard class library with C# and the .NET Core SDK in Visual Studio 2017

Eine Klassenbibliothek definiert die Typen und Methoden, die von einer Anwendung aufgerufen werden können.A class library defines types and methods that are called by an application. Eine Klassenbibliothek, die sich auf .NET Standard 2.0 bezieht, ermöglicht das Aufrufen der Bibliothek aus jeder .NET-Implementierung, die diese Version von .NET Standard unterstützt.A class library that targets the .NET Standard 2.0 allows your library to be called by any .NET implementation that supports that version of the .NET Standard. Wenn Sie die Klassenbibliothek fertig stellen, können Sie entscheiden, ob Sie sie als Drittanbieterkomponente verteilen oder als Komponente mit einer oder mehreren Anwendungen in ein Paket einbeziehen möchten.When you finish your class library, you can decide whether you want to distribute it as a third-party component or whether you want to include it as a bundled component with one or more applications.

Hinweis

Eine Liste der .NET Standard-Versionen und der Plattformen, die sie unterstützen, finden Sie unter .NET-Standard.For a list of the .NET Standard versions and the platforms they support, see .NET Standard.

In diesem Thema erstellen Sie eine einfache Hilfsprogrammbibliothek, die eine einzelne Methode zur Behandlung von Zeichenfolgen enthält.In this topic, you'll create a simple utility library that contains a single string-handling method. Sie implementieren sie als Erweiterungsmethode, damit sie aufgerufen werden kann, als wäre sie ein Mitglied der String Klasse.You'll implement it as an extension method so that you can call it as if it were a member of the String class.

Erstellen einer Klassenbibliotheks-ProjektmappeCreating a class library solution

Zunächst erstellen Sie eine Projektmappe für Ihre Klassenbibliotheksprojekt und die zugehörigen Projekte.Start by creating a solution for your class library project and its related projects. Eine Visual Studio-Projektmappe dient nur als Container für ein oder mehrere Projekte.A Visual Studio Solution just serves as a container for one or more projects. So erstellen Sie die Projektmappe:To create the solution:

  1. Wählen Sie auf der Visual Studio-Menüleiste Datei > Neu > Projekt aus.On the Visual Studio menu bar, choose File > New > Project.

  2. Erweitern Sie im Dialogfeld Neues Projekt den Knoten Andere Projekttypen, und wählen Sie Visual Studio-Projektmappen aus.In the New Project dialog, expand the Other Project Types node, and select Visual Studio Solutions. Nennen Sie die Projektmappe „ClassLibraryProjects“, und wählen Sie die OK-Schaltfläche aus.Name the solution "ClassLibraryProjects" and select the OK button.

    Dialogfeld "Neues Projekt"

Erstellen des KlassenbibliotheksprojektsCreating the class library project

Erstellen Sie Ihr Klassenbibliotheksprojekt:Create your class library project:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappendatei ClassLibraryProjects, und wählen Sie im Kontextmenü Hinzufügen > Neues Projekt aus.In Solution Explorer, right-click on the ClassLibraryProjects solution file and from the context menu, select Add > New Project.

  2. Erweitern Sie den Knoten Visual C# im Dialogfeld Neues Projekt hinzufügen, klicken Sie dann auf den Knoten .NET Standard und anschließend auf die Projektvorlage Klassenbibliothek (.NET Standard).In the Add New Project dialog, expand the Visual C# node, then select the .NET Standard node followed by the Class Library (.NET Standard) project template. Geben Sie im Textfeld Name „StringLibrary“ als Namen des Projekts ein.In the Name text box, enter "StringLibrary" as the name of the project. Wählen Sie OK, um das Klassenbibliotheksprojekt zu erstellen.Select OK to create the class library project.

    Dialogfeld „Neues Projekt hinzufügen“

    Das Codefenster öffnet sich dann in der Visual Studio-Entwicklungsumgebung.The code window then opens in the Visual Studio development environment.

    Visual Studio-Anwendungsfenster, das die den Standardvorlagencode der Klassenbibliothek zeigt

  3. Stellen Sie sicher, dass die Bibliothek die richtige Version von .NET Standard als Ziel verwendet.Check to make sure that our library targets the correct version of the .NET Standard. Klicken Sie mit der rechten Maustaste auf das Bibliotheksprojekt im Fenster des Projektmappen-Explorer, und klicken Sie dann auf Eigenschaften.Right-click on the library project in the Solution Explorer windows, then select Properties. Das Textfeld Zielframework zeigt dann, dass .NET Standard 2.0 als Ziel verwendet wird.The Target Framework text box shows that we're targeting .NET Standard 2.0.

    Projekteigenschaften für die Klassenbibliothek

  4. Ersetzen Sie den Code im Codefenster durch den folgenden Code, und speichern Sie die Datei:Replace the code in the code window with the following code and save the file:

    using System;
    
    namespace UtilityLibraries
    {
        public static class StringLibrary
        {
            public static bool StartsWithUpper(this String str)
            {
                if (String.IsNullOrWhiteSpace(str))
                    return false;
    
                Char ch = str[0];
                return Char.IsUpper(ch);
            }
        }
    }
    

    Die Klassenbibliothek, UtilityLibraries.StringLibrary, enthält eine Methode namens StartsWithUpper, welche einen Boolean Wert zurückgibt, der angibt, ob die aktuelle Zeichenfolgeninstanz mit einem Großbuchstaben beginnt.The class library, UtilityLibraries.StringLibrary, contains a method named StartsWithUpper, which returns a Boolean value that indicates whether the current string instance begins with an uppercase character. Der Unicode-Standard unterscheidet Groß- und Kleinschreibung.The Unicode standard distinguishes uppercase characters from lowercase characters. Die Methode Char.IsUpper(Char) gibt true zurück, wenn ein Zeichen ein Großbuchstabe ist.The Char.IsUpper(Char) method returns true if a character is uppercase.

  5. Wählen Sie auf der Menüleiste Erstellen > Projektmappe erstellen aus.On the menu bar, select Build > Build Solution. Das Projekt sollte fehlerfrei kompiliert werden.The project should compile without error.

    Ausgabebereich, der zeigt, dass der Buildvorgang erfolgreich war

Nächster SchrittNext step

Sie haben die Bibliothek erfolgreich erstellt.You've successfully built the library. Aber da Sie keine ihrer Methoden aufgerufen haben, wissen Sie nicht, ob sie wie erwartet funktioniert.Because you haven't called any of its methods, you don't know whether it works as expected. Der nächste Schritt bei der Entwicklung Ihrer Bibliothek ist ihr Test mithilfe eines Komponententestprojekts.The next step in developing your library is to test it by using a Unit Test Project.