Lernprogramm: Erstellen einer .NET-Klassenbibliothek mit Visual Studio Code

In diesem Lernprogramm erstellen Sie eine einfache Hilfsprogrammbibliothek, die eine einzelne Zeichenfolgenbehandlungsmethode enthält.

Eine Klassenbibliothek definiert Typen und Methoden, die von einer Anwendung aufgerufen werden. Wenn die Bibliothek auf .NET Standard 2.0 ausgerichtet ist, kann sie von jeder .NET-Implementierung (einschließlich .NET Framework) aufgerufen werden, die .NET Standard 2.0 unterstützt. Wenn die Bibliothek auf .NET 9 ausgerichtet ist, kann sie von jeder Anwendung aufgerufen werden, die auf .NET 9 ausgerichtet ist. In diesem Tutorial wird gezeigt, wie man .NET 9 als Zielplattform verwendet.

Wenn Sie eine Klassenbibliothek erstellen, können Sie sie als Drittanbieterkomponente oder als gebündelte Komponente mit einer oder mehreren Anwendungen verteilen.

Voraussetzungen

Das neueste .NET SDK
Visual Studio Code-Editor
Das C# DevKit

Installationsanweisungen

Unter Windows diese WinGet-Konfigurationsdatei zum Installieren aller erforderlichen Komponenten. Wenn Sie bereits etwas installiert haben, überspringt WinGet diesen Schritt.

Laden Sie die Datei herunter, und doppelklicken Sie, um sie auszuführen.
Lesen Sie den Lizenzvertrag, geben Sie yein, und wählen Sie Geben Sie ein, wenn Sie zur Annahme aufgefordert werden.
Wenn Sie in Ihrer Taskleiste eine blinkende Eingabeaufforderung für die Benutzerkontensteuerung (User Account Control, UAC) erhalten, können Sie die Installation fortsetzen.

Auf anderen Plattformen müssen Sie jede dieser Komponenten separat installieren.

Laden Sie das empfohlene Installationsprogramm von der .NET SDK-Downloadseite herunter , und doppelklicken Sie, um es auszuführen. Die Downloadseite erkennt Ihre Plattform und empfiehlt das neueste Installationsprogramm für Ihre Plattform.
Laden Sie das neueste Installationsprogramm von der Visual Studio Code Startseite herunter, und doppelklicken Sie, um es auszuführen. Diese Seite erkennt auch Ihre Plattform, und der Link sollte für Ihr System korrekt sein.
Klicken Sie auf der Erweiterungsseite C# DevKit auf die Schaltfläche "Installieren". Dadurch wird Visual Studio-Code geöffnet und gefragt, ob Sie die Erweiterung installieren oder aktivieren möchten. Wählen Sie "Installieren" aus.

Erstellen eines Klassenbibliotheksprojekts

Erstellen Sie zunächst ein .NET-Klassenbibliotheksprojekt namens "StringLibrary" und eine zugeordnete Lösung. Eine Lösung dient als Container für ein oder mehrere Projekte. Sie fügen der gleichen Projektmappe weitere verwandte Projekte hinzu.

Starten Sie Visual Studio Code.
Wechseln Sie zur Explorer-Ansicht, und wählen Sie ".NET-Projekt erstellen" aus. Alternativ können Sie die Befehlspalette mit STRG+UMSCHALT+P (Befehl+UMSCHALT+P unter MacOS) aufrufen und dann ".NET" eingeben und den Befehl .NET: Neues Projekt suchen und auswählen.
Nachdem Sie den Befehl ausgewählt haben, müssen Sie die Projektvorlage auswählen. Wählen Sie "Klassenbibliothek" aus.
Wählen Sie dann den Speicherort aus, an dem das neue Projekt erstellt werden soll.
Wählen Sie dann den Speicherort aus, an dem das neue Projekt erstellt werden soll: Erstellen Sie einen Ordner mit dem Namen ClassLibraryProjects , und wählen Sie ihn aus.
Benennen Sie das Projekt StringLibrary, wählen Sie "Alle Vorlagenoptionen anzeigen" aus, wählen Sie .NET 9 und dann "Projekt erstellen" aus.
Benennen Sie das Projekt StringLibrary , und wählen Sie "Projekt erstellen" aus.
Drücken Sie die EINGABETASTE an der Eingabeaufforderung Das Projekt wird im <Pfad> erstellt.
Stellen Sie sicher, dass die Bibliothek auf .NET 9 ausgerichtet ist. Öffnen Sie im ExplorerStringLibrary/StringLibrary.csproj.

Das TargetFramework Element zeigt, dass das Projekt auf .NET 9.0 ausgerichtet ist.
```
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>
```
Öffnen Sie Class1.cs , und ersetzen Sie den Code durch den folgenden Code.
```
namespace UtilityLibraries;

public static class StringLibrary
{
    public static bool StartsWithUpper(this string? str)
    {
        if (string.IsNullOrWhiteSpace(str))
            return false;

        return char.IsUpper(str[0]);
    }
}
```
Die Klassenbibliothek, UtilityLibraries.StringLibrary, enthält eine Methode mit dem Namen StartsWithUpper. Diese Methode gibt einen Boolean Wert zurück, der angibt, ob die aktuelle Zeichenfolgeninstanz mit einem Großbuchstaben beginnt. Der Unicode-Standard unterscheidet Großbuchstaben von Kleinbuchstaben. Die Methode Char.IsUpper(Char) gibt true zurück, wenn ein Zeichen ein Großbuchstabe ist.

Die Methode StartsWithUpper wird als Erweiterungsmethode implementiert, damit sie wie ein Member der Klasse String aufgerufen werden kann.
Speichern Sie die Datei.
Erweitern Sie den Lösungs-Explorer unten in der Explorer-Ansicht.

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, und wählen Sie " Erstellen" aus, oder öffnen Sie die Befehlspalette, und wählen Sie .NET aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt ohne Fehler kompiliert wird.

Die Terminalausgabe sieht wie im folgenden Beispiel aus:

Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net9.0\StringLibrary.dll
Build succeeded.
    0 Warning(s)
    0 Error(s)
Time Elapsed 00:00:02.78

Hinzufügen einer Konsolen-App zur Lösung

Fügen Sie eine Konsolenanwendung hinzu, die die Klassenbibliothek verwendet. Die App fordert den Benutzer auf, eine Zeichenfolge einzugeben und zu melden, ob die Zeichenfolge mit einem Großbuchstaben beginnt.

Klicken Sie mit der rechten Maustaste auf die Projektmappe im Projektmappen-Explorer und wählen Sie Neues Projekt aus, oder wählen Sie in der Befehlspalette .NET: Neues Projekt aus.
Wählen Sie "Konsolen-App" aus.
Geben Sie ihm den Namen ShowCase, wählen Sie den Standardspeicherort und dann "Projekt erstellen" aus.

Öffnen Sie ShowCase/Program.cs , und ersetzen Sie den gesamten Code durch den folgenden Code.

using System;
using UtilityLibraries;

class Program
{
    static void Main(string[] args)
    {
        int row = 0;

        do
        {
            if (row == 0 || row >= 25)
                ResetConsole();

            string? input = Console.ReadLine();
            if (string.IsNullOrEmpty(input)) break;
            Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                              $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
            row += 3;
        } while (true);
        return;

        // Declare a ResetConsole local method
        void ResetConsole()
        {
            if (row > 0)
            {
                Console.WriteLine("Press any key to continue...");
                Console.ReadKey();
            }
            Console.Clear();
            Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
            row = 3;
        }
    }
}

Der Code verwendet die row-Variable, um die Anzahl der in das Konsolenfenster geschriebenen Datenzeilen festzuhalten. Wenn er größer als oder gleich 25 ist, löscht der Code das Konsolenfenster und zeigt dem Benutzer eine Meldung an.

Das Programm fordert den Benutzer auf, eine Zeichenfolge einzugeben. Es zeigt an, ob die Zeichenfolge mit einem Großbuchstaben beginnt. Wenn der Benutzer die Eingabetaste drückt, ohne eine Zeichenfolge einzugeben, endet die Anwendung und das Konsolenfenster wird geschlossen.

Speichern Sie Ihre Änderungen.

Hinzufügen eines Projektverweises

Zunächst hat das neue Konsolen-App-Projekt keinen Zugriff auf die Klassenbibliothek. Damit Methoden in der Klassenbibliothek aufgerufen werden können, erstellen Sie einen Projektverweis auf das Klassenbibliotheksprojekt.

Klicken Sie mit der rechten Maustaste im Projektmappen-Explorer auf das ShowCase-Projekt und wählen Sie Projektverweis hinzufügen aus.
Wählen Sie "StringLibrary" aus.

App starten

Wählen Sie Ausführen>Ohne Debugging ausführen.
Wählen Sie C#.
Wählen Sie "ShowCase" aus.

Wenn ein Fehler angezeigt wird, der besagt, dass kein C#-Programm geladen wird, schließen Sie den ordner, den Sie geöffnet haben, und öffnen Sie den ShowCase Ordner. Versuchen Sie dann erneut, die App auszuführen.

Probieren Sie das Programm aus, indem Sie Zeichenfolgen eingeben und die Taste Enterdrücken, und drücken Sie dann die Taste Enter, um den Vorgang zu beenden.

Die Terminalausgabe sieht wie im folgenden Beispiel aus:

Press <Enter> only to exit; otherwise, enter a string and press <Enter>:

A string that starts with an uppercase letter
Input: A string that starts with an uppercase letter
Begins with uppercase? : Yes

a string that starts with a lowercase letter
Input: a string that starts with a lowercase letter
Begins with uppercase? : No

Weitere Ressourcen

Nächste Schritte

In diesem Lernprogramm haben Sie ein Bibliotheksprojekt erstellt und ein Konsolen-App-Projekt hinzugefügt, das die Bibliothek verwendet. Im nächsten Tutorial fügen Sie der Projektmappe ein Unittestprojekt hinzu.

Testen einer .NET-Klassenbibliothek mit .NET mithilfe von Visual Studio Code

Feedback

War diese Seite hilfreich?

Last updated on 2025-12-02