Tutorial: Erstellen einer .NET-Klassenbibliothek in Visual Studio für Mac

Artikel
09/12/2023

Wichtig

Microsoft hat die Einstellung von Visual Studio für Mac angekündigt. Visual Studio für Mac wird ab dem 31. August 2024 nicht mehr unterstützt. Zu den Alternativen gehören:

Visual Studio Code mit dem C# Dev-Kit und verwandten Erweiterungen, z. B. .NET MAUI und Unity.
Visual Studio läuft unter Windows in einer VM auf einem Mac.
Visual Studio läuft unter Windows in einer VM in der Cloud.

Weitere Informationen finden Sie in der Einstellungsankündigung von Visual Studio für Mac.

In diesem Tutorial erstellen Sie eine einfache Klassenbibliothek, die eine einzelne Methode zur Behandlung von Zeichenfolgen enthält.

Eine Klassenbibliothek definiert die Typen und Methoden, die von einer Anwendung aufgerufen werden können. Wenn die Bibliothek auf .NET Standard 2.0 ausgelegt 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 5 ausgelegt ist, kann sie von jeder Anwendung aufgerufen werden, die auf .NET 5 ausgerichtet ist. In diesem Tutorial erfahren Sie, wie Sie .NET 5 als Zielversion verwenden.

Hinweis

Ihr Feedback ist uns sehr wichtig. Es gibt zwei Möglichkeiten, wie Sie Feedback für das Entwicklungsteam von Visual Studio für Mac bereitstellen können:

Klicken Sie in Visual Studio für Mac auf Hilfe>Ein Problem melden im Menü oder auf Ein Problem melden auf der Willkommensseite. Dadurch wird ein Fenster für das Einreichen eines Fehlerberichts geöffnet. Sie können Ihr Feedback im Portal der Entwicklercommunity verfolgen.
Um einen Vorschlag zu machen, wählen Sie Hilfe>Vorschlag senden im Menü oder Vorschlag senden auf der Willkommensseite aus. Dadurch gelangen Sie zur Webseite Visual Studio für Mac-Entwicklercommunity.

Voraussetzungen

Installieren von Visual Studio für Mac Version 8.8 oder höher. Wählen Sie die Option zum Installieren von .NET Core aus. Die Installation von Xamarin ist für die Entwicklung mit .NET optional. Weitere Informationen finden Sie in den folgenden Ressourcen:

Erstellen einer Projektmappe mit einem Klassenbibliotheksprojekt

Eine Visual Studio-Projektmappe dient als ein Container für mindestens ein Projekt. Erstellen Sie eine Projektmappe und darin ein Klassenbibliotheksprojekt. Sie fügen später der gleichen Projektmappe weitere verwandte Projekte hinzu.

Starten Sie Visual Studio für Mac.
Wählen Sie im Startfenster Neues Projekt aus.
Wählen Sie im Dialogfeld Vorlage für neues Projekt auswählen die Option Web und Konsole>Bibliothek>Klassenbibliothek aus, und wählen Sie dann Weiter aus.
Wählen Sie im Dialogfeld Neue Klassenbibliothek konfigurieren die Option NET 5.0 und dann Weiter aus.
Nennen Sie die Projektmappe „StringLibrary“ und die Projektmappe „ClassLibraryProjects“. Lassen Sie Projektverzeichnis im Projektmappenverzeichnis erstellen aktiviert. Klicken Sie auf Erstellen.
Wählen Sie im Hauptmenü Ansicht>Projektmappe und dann das Andocksymbol aus, um das Pad geöffnet zu halten.
Erweitern Sie im Pad Projektmappe den Knoten StringLibrary, um die von der Vorlage bereitgestellte Klassendatei Class1.cs anzuzeigen. Klicken Sie bei gedrückter STRG-Taste auf die Datei, wählen Sie aus dem Kontextmenü den Eintrag Umbenennen aus, und benennen Sie die Datei in StringLibrary.cs um. Öffnen Sie die Datei und ersetzen Sie den Inhalt durch den folgenden Code:
```
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);
        }
    }
}
```
Drücken Sie ⌘S (BEFEHL+S), um die Datei zu speichern.
Wählen Sie am unteren Rand des IDE-Fensters Fehler aus, um den Bereich Fehler zu öffnen. Wählen Sie die Schaltfläche Buildausgabe aus.
Klicken Sie im Menü auf Build>Build All (Erstellen > Alle erstellen).

Die Projektmappe wird erstellt. Im Bereich „Buildausgabe“ wird angezeigt, dass der Build erfolgreich erstellt wurde.

Hinzufügen einer Konsolen-App zur Projektmappe

Im Folgenden fügen Sie eine Konsolenanwendung hinzu, die die Klassenbibliothek verwendet. Die App fordert den Benutzer dazu auf, eine Zeichenfolge einzugeben, und meldet, ob die Zeichenfolge mit einem Großbuchstaben beginnt.

Klicken Sie im Pad Projektmappe bei gedrückter CTRL-TASTE auf die Projektmappe ClassLibraryProjects. Fügen Sie ein neues Konsolenanwendungsprojekt hinzu, indem Sie die Vorlage aus den Vorlagen unter Web und Konsole>App und dann Weiter auswählen.
Wählen Sie .NET 5.0 als Zielframework und anschließend Weiter aus.
Geben Sie dem Projekt den Namen ShowCase. Wählen Sie Erstellen aus, um das Projekt in der Projektmappe zu erstellen.

Öffnen Sie die Datei Program.cs. Ersetzen Sie den 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;
        }
    }
}

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

Der Code verwendet die row-Variable, um die Anzahl der in das Konsolenfenster geschriebenen Datenzeilen festzuhalten. Wenn sie mindestens 25 beträgt, löscht der Code das Konsolenfenster und zeigt eine Meldung für den Benutzer an.

Hinzufügen eines Projektverweises

Anfänglich besitzt das neue Konsolen-App-Projekt keinen Zugriff auf die Klassenbibliothek. Damit es Methoden in der Klassenbibliothek aufrufen kann, erstellen Sie einen Projektverweis auf das Klassenbibliotheksprojekt.

Klicken Sie im Pad Projektmappe bei gedrückter CTRL-TASTE im neuen Projekt ShowCase auf den Knoten Abhängigkeiten. Wählen Sie im Kontextmenü Verweis hinzufügen aus.
Wählen Sie im Dialogfeld Verweise das Projekt StringLibrary und dann OK aus.

Ausführen der App

Klicken Sie bei gedrückter STRG-TASTE auf das Projekt ShowCase, und wählen Sie im Kontextmenü Projekt ausführen aus.
Testen Sie das Programm, indem Sie Zeichenfolgen eingeben und die EINGABETASTE drücken. Drücken Sie dann die EINGABETASTE, um das Programm zu beenden.

Zusätzliche Ressourcen

Nächste Schritte

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

Testen einer .NET-Klassenbibliothek in Visual Studio für Mac