Tutorial: Erstellen einer .NET-Klassenbibliothek in 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

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.

  1. Starten Sie Visual Studio für Mac.

  2. Wählen Sie im Startfenster Neues Projekt aus.

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

    Dialogfeld Neues Projekt

  4. Wählen Sie im Dialogfeld Neue Klassenbibliothek konfigurieren die Option NET 5.0 und dann Weiter aus.

  5. Nennen Sie die Projektmappe „StringLibrary“ und die Projektmappe „ClassLibraryProjects“. Lassen Sie Projektverzeichnis im Projektmappenverzeichnis erstellen aktiviert. Wählen Sie Erstellen aus.

    Visual Studio für Mac, Optionen im Dialogfeld „Neues Projekt“

  6. Wählen Sie im Hauptmenü Ansicht > Projektmappe und dann das Andocksymbol aus, um das Pad geöffnet zu halten.

    Andocksymbol für Pad „Projektmappe“

  7. Erweitern Sie im Pad Projektmappe den StringLibrary-Knoten, um die von der Vorlage bereitgestellte Klassendatei Class1.cs anzuzeigen. Klicken Sie bei gedrückter CTRL-TASTE auf die Datei. Wählen Sie im Kontextmenü 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);
            }
        }
    }
    
  8. Drücken Sie S (BEFEHL+S), um die Datei zu speichern.

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

    Unterer Rand der IDE mit Schaltfläche „Fehler“ in Visual Studio für Mac

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

    Visual Studio für Mac, Buildausgabebereich im Bereich „Fehler“ mit Meldung, dass der Build erfolgreich war

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.

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

  2. Wählen Sie .NET 5.0 als Zielframework und anschließend Weiter aus.

  3. Geben Sie dem Projekt den Namen ShowCase. Wählen Sie Erstellen aus, um das Projekt in der Projektmappe zu erstellen.

    Projekt „ShowCase“ hinzufügen

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

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

  2. Wählen Sie im Dialogfeld Verweise das Projekt StringLibrary und dann OK aus.

Ausführen der App

  1. Klicken Sie bei gedrückter STRG-TASTE auf das Projekt ShowCase, und wählen Sie im Kontextmenü Projekt ausführen aus.

  2. Testen Sie das Programm, indem Sie Zeichenfolgen eingeben und die EINGABETASTE drücken. Drücken Sie dann die EINGABETASTE, um das Programm zu beenden.

    Visual Studio für Mac-Konsolenfenster, das Ihre App bei der Ausführung zeigt

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.