Erstellen einer .NET Standard-Bibliothek in Visual StudioBuild a .NET Standard library in Visual Studio

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 .NET Standard 2.0 allows your library to be called by any .NET implementation that supports that version of .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 .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 Visual Studio-ProjektmappeCreate a Visual Studio solution

Beginnen Sie, indem Sie eine leere Projektmappe erstellen, um das Klassenbibliotheksprojekt darin zu speichern.Start by creating a blank solution to put the class library project in. Eine Visual Studio-Projektmappe dient als ein Container für mindestens ein Projekt.A Visual Studio solution serves as a container for one or more projects. Wenn Sie mit der Tutorialreihe fortfahren, werden Sie der gleichen Projektmappe weitere verwandte Projekte hinzufügen.You'll add additional, related projects to the same solution if you continue on with the tutorial series.

So erstellen Sie eine leere Projektmappe:To create the blank solution:

  1. Öffnen Sie Visual Studio.Open Visual Studio.

  2. Wählen Sie im Startfenster Neues Projekt erstellen aus.On the start window, choose Create a new project.

  3. Geben Sie auf der Seite Neues Projekt erstellen die Angabe Projektmappe in das Suchfeld ein.On the Create a new project page, enter solution in the search box. Wählen Sie die Vorlage Leere Projektmappe aus, und klicken Sie dann auf Weiter.Choose the Blank Solution template, and then choose Next.

    Vorlage „Leere Projektmappe“ in Visual Studio

  4. Geben Sie im auf der Seite Neues Projekt konfigurieren im Feld Projektname den Namen ClassLibraryProjects ein.On the Configure your new project page, enter ClassLibraryProjects in the Project name box. Wählen Sie anschließend Erstellen aus.Then, choose Create.

Tipp

Sie können diesen Schritt auch überspringen und Visual Studio die Projektmappe für Sie erstellen lassen, wenn Sie das Projekt im nächsten Schritt erstellen.You can also skip this step and let Visual Studio create the solution for you when you create the project in the next step. Suchen Sie auf der Seite Neues Projekt konfigurieren nach den Projektmappenoptionen.Look for the solution options on the Configure your new project page.

Erstellen eines KlassenbibliotheksprojektsCreate a class library project

  1. Fügen Sie der Projektmappe ein neues C# .NET Standard-Klassenbibliotheksprojekt mit dem Namen „StringLibrary“ hinzu.Add a new C# .NET Standard class library project named "StringLibrary" to the solution.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, und wählen Sie Hinzufügen > Neues Projekt aus.Right-click on the solution in Solution Explorer and select Add > New project.

    2. Geben Sie auf der Seite Neues Projekt hinzufügen library in das Suchfeld ein.On the Add a new project page, enter library in the search box. Wählen Sie in der Liste der Sprachen C# und dann in der Liste der Plattformen Alle Plattformen aus.Choose C# from the Language list, and then choose All platforms from the Platform list. Wählen Sie die Vorlage Klassenbibliothek (.NET Standard) aus, und wählen Sie dann Weiteraus.Choose the Class Library (.NET Standard) template, and then choose Next.

    3. Geben Sie im auf der Seite Neues Projekt konfigurieren im Feld Projektname den Namen StringLibrary ein.On the Configure your new project page, enter StringLibrary in the Project name box. Wählen Sie anschließend Erstellen aus.Then, choose Create.

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

    Projekteigenschaften für die Klassenbibliothek

  3. 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.The class library, UtilityLibraries.StringLibrary, contains a method named StartsWithUpper. Diese Methode gibt einen Boolean-Wert zurück, der angibt, ob die aktuelle Zeichenfolgeninstanz mit einem Großbuchstaben beginnt.This method 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.

  4. 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.

Nächste SchritteNext steps

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 besteht aus Tests.The next step in developing your library is to test it.