Freigeben über


Tutorial: Erstellen einer .NET-Klassenbibliothek in Visual Studio Code

In diesem Tutorial erstellen Sie eine einfache Hilfsprogrammbibliothek, 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 8 ausgelegt ist, kann sie von jeder Anwendung aufgerufen werden, die auf .NET 8 ausgerichtet ist. In diesem Tutorial erfahren Sie, wie Sie .NET 8 als Ziel verwenden.

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

Voraussetzungen

Erstellen einer Projektmappe

Beginnen Sie, indem Sie eine leere Projektmappe erstellen, um das Klassenbibliotheksprojekt darin zu speichern. Eine Projektmappe dient als ein Container für mindestens ein Projekt. Sie fügen der gleichen Projektmappe weitere verwandte Projekte hinzu.

  1. Starten Sie Visual Studio Code.

  2. Wählen Sie im Hauptmenü Datei>Ordner öffnen (Öffnen... unter macOS) aus.

  3. Erstellen Sie im Dialogfeld Ordner öffnen den Ordner ClassLibraryProjects, und klicken Sie auf Ordner auswählen (Öffnen unter macOS).

  4. Öffnen Sie das Terminal in Visual Studio Code, indem Sie im Hauptmenü Ansicht>Terminal auswählen.

    Das Terminal wird mit der Eingabeaufforderung im Ordner ClassLibraryProjects geöffnet.

  5. Geben Sie im Terminal den folgenden Befehl ein:

    dotnet new sln
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Solution File" was created successfully.
    

Erstellen eines Klassenbibliotheksprojekts

Fügen Sie ein neues .NET-Klassenbibliotheksprojekt namens „StringLibrary“ zur Projektmappe hinzu.

  1. Führen Sie im Terminal den folgenden Befehl aus, um das Bibliotheksprojekt zu erstellen:

    dotnet new classlib -o StringLibrary
    

    Der Befehl -o oder --output gibt den Speicherort für die generierte Ausgabe an.

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Class library" was created successfully.
    Processing post-creation actions...
    Running 'dotnet restore' on StringLibrary\StringLibrary.csproj...
      Determining projects to restore...
      Restored C:\Projects\ClassLibraryProjects\StringLibrary\StringLibrary.csproj (in 328 ms).
    Restore succeeded.
    
  2. Führen Sie den folgenden Befehl aus, um das Bibliotheksprojekt zur Projektmappe hinzuzufügen:

    dotnet sln add StringLibrary/StringLibrary.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Project `StringLibrary\StringLibrary.csproj` added to the solution.
    
  3. Stellen Sie sicher, dass die Bibliothek auf .NET 8 als Ziel hat. Öffnen Sie im Explorer die Datei StringLibrary/StringLibrary.csproj.

    Das Element TargetFramework gibt an, dass das Projekt .NET 8.0 als Ziel hat.

    <Project Sdk="Microsoft.NET.Sdk">
    
      <PropertyGroup>
        <TargetFramework>net8.0</TargetFramework>
      </PropertyGroup>
    
    </Project>
    
  4. Öffnen Sie die Datei Class1.cs, und ersetzen Sie den Code durch den folgenden:

    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. Diese Methode gibt einen Boolean-Wert zurück, der angibt, ob die aktuelle Zeichenfolgeninstanz mit einem Großbuchstaben beginnt. Der Unicode-Standard unterscheidet Groß- und Kleinschreibung. 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.

  5. Speichern Sie die Datei.

  6. Führen Sie den folgenden Befehl aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt fehlerfrei kompiliert wird:

    dotnet build
    

    Die Terminalausgabe sieht wie das folgende 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\net8.0\StringLibrary.dll
    Build succeeded.
        0 Warning(s)
        0 Error(s)
    Time Elapsed 00:00:02.78
    

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. Führen Sie im Terminal den folgenden Befehl aus, um das Konsolen-App-Projekt zu erstellen:

    dotnet new console -o ShowCase
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Console Application" was created successfully.
    Processing post-creation actions...
    Running 'dotnet restore' on ShowCase\ShowCase.csproj...
      Determining projects to restore...
      Restored C:\Projects\ClassLibraryProjects\ShowCase\ShowCase.csproj (in 210 ms).
    Restore succeeded.
    
  2. Führen Sie den folgenden Befehl aus, um das Konsolen-App-Projekt zur Projektmappe hinzuzufügen:

    dotnet sln add ShowCase/ShowCase.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Project `ShowCase\ShowCase.csproj` added to the solution.
    
  3. Öffnen Sie die Datei ShowCase/Program.cs, und ersetzen Sie den gesamten Code durch den folgenden:

    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}");
                Console.WriteLine("Begins with uppercase? " +
                     $"{(input.StartsWithUpper() ? "Yes" : "No")}");
                Console.WriteLine();
                row += 4;
            } 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 sie mindestens 25 beträgt, löscht der Code das Konsolenfenster und zeigt eine Meldung für den Benutzer an.

    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.

  4. Speichern Sie die Änderungen.

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. Führen Sie den folgenden Befehl aus:

    dotnet add ShowCase/ShowCase.csproj reference StringLibrary/StringLibrary.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Reference `..\StringLibrary\StringLibrary.csproj` added to the project.
    

Ausführen der App

  1. Führen Sie die folgenden Befehle im Terminal aus:

    dotnet run --project ShowCase/ShowCase.csproj
    
  2. Testen Sie das Programm, indem Sie Zeichenfolgen eingeben und die EINGABETASTE drücken, und drücken Sie dann die EINGABETASTE, um das Programm zu beenden.

    Die Terminalausgabe sieht wie das folgende 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
    

Zusätzliche Ressourcen

Nächste Schritte

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

In diesem Tutorial erstellen Sie eine einfache Hilfsprogrammbibliothek, 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 .NET 7 als Ziel hat, kann sie von jeder Anwendung aufgerufen werden, die .NET 7 als Ziel hat. In diesem Tutorial erfahren Sie, wie Sie .NET 7 als Ziel verwenden.

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

Voraussetzungen

Erstellen einer Projektmappe

Beginnen Sie, indem Sie eine leere Projektmappe erstellen, um das Klassenbibliotheksprojekt darin zu speichern. Eine Projektmappe dient als ein Container für mindestens ein Projekt. Sie fügen der gleichen Projektmappe weitere verwandte Projekte hinzu.

  1. Starten Sie Visual Studio Code.

  2. Wählen Sie im Hauptmenü Datei>Ordner öffnen (Öffnen... unter macOS) aus.

  3. Erstellen Sie im Dialogfeld Ordner öffnen den Ordner ClassLibraryProjects, und klicken Sie auf Ordner auswählen (Öffnen unter macOS).

  4. Öffnen Sie das Terminal in Visual Studio Code, indem Sie im Hauptmenü Ansicht>Terminal auswählen.

    Das Terminal wird mit der Eingabeaufforderung im Ordner ClassLibraryProjects geöffnet.

  5. Geben Sie im Terminal den folgenden Befehl ein:

    dotnet new sln
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Solution File" was created successfully.
    

Erstellen eines Klassenbibliotheksprojekts

Fügen Sie ein neues .NET-Klassenbibliotheksprojekt namens „StringLibrary“ zur Projektmappe hinzu.

  1. Führen Sie im Terminal den folgenden Befehl aus, um das Bibliotheksprojekt zu erstellen:

    dotnet new classlib -o StringLibrary
    

    Der Befehl -o oder --output gibt den Speicherort für die generierte Ausgabe an.

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Class library" was created successfully.
    Processing post-creation actions...
    Running 'dotnet restore' on StringLibrary\StringLibrary.csproj...
      Determining projects to restore...
      Restored C:\Projects\ClassLibraryProjects\StringLibrary\StringLibrary.csproj (in 328 ms).
    Restore succeeded.
    
  2. Führen Sie den folgenden Befehl aus, um das Bibliotheksprojekt zur Projektmappe hinzuzufügen:

    dotnet sln add StringLibrary/StringLibrary.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Project `StringLibrary\StringLibrary.csproj` added to the solution.
    
  3. Stellen Sie sicher, dass die Bibliothek .NET 7 als Ziel hat. Öffnen Sie im Explorer die Datei StringLibrary/StringLibrary.csproj.

    Das Element TargetFramework gibt an, dass das Projekt .NET 7.0 als Ziel hat.

    <Project Sdk="Microsoft.NET.Sdk">
    
      <PropertyGroup>
        <TargetFramework>net7.0</TargetFramework>
      </PropertyGroup>
    
    </Project>
    
  4. Öffnen Sie die Datei Class1.cs, und ersetzen Sie den Code durch den folgenden:

    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. Diese Methode gibt einen Boolean-Wert zurück, der angibt, ob die aktuelle Zeichenfolgeninstanz mit einem Großbuchstaben beginnt. Der Unicode-Standard unterscheidet Groß- und Kleinschreibung. 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.

  5. Speichern Sie die Datei.

  6. Führen Sie den folgenden Befehl aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt fehlerfrei kompiliert wird:

    dotnet build
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Microsoft (R) Build Engine version 16.7.4+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\net7.0\StringLibrary.dll
    Build succeeded.
        0 Warning(s)
        0 Error(s)
    Time Elapsed 00:00:02.78
    

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. Führen Sie im Terminal den folgenden Befehl aus, um das Konsolen-App-Projekt zu erstellen:

    dotnet new console -o ShowCase
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Console Application" was created successfully.
    Processing post-creation actions...
    Running 'dotnet restore' on ShowCase\ShowCase.csproj...
      Determining projects to restore...
      Restored C:\Projects\ClassLibraryProjects\ShowCase\ShowCase.csproj (in 210 ms).
    Restore succeeded.
    
  2. Führen Sie den folgenden Befehl aus, um das Konsolen-App-Projekt zur Projektmappe hinzuzufügen:

    dotnet sln add ShowCase/ShowCase.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Project `ShowCase\ShowCase.csproj` added to the solution.
    
  3. Öffnen Sie die Datei ShowCase/Program.cs, und ersetzen Sie den gesamten Code durch den folgenden:

    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}");
                Console.WriteLine("Begins with uppercase? " +
                     $"{(input.StartsWithUpper() ? "Yes" : "No")}");
                Console.WriteLine();
                row += 4;
            } 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 sie mindestens 25 beträgt, löscht der Code das Konsolenfenster und zeigt eine Meldung für den Benutzer an.

    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.

  4. Speichern Sie die Änderungen.

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. Führen Sie den folgenden Befehl aus:

    dotnet add ShowCase/ShowCase.csproj reference StringLibrary/StringLibrary.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Reference `..\StringLibrary\StringLibrary.csproj` added to the project.
    

Ausführen der App

  1. Führen Sie die folgenden Befehle im Terminal aus:

    dotnet run --project ShowCase/ShowCase.csproj
    
  2. Testen Sie das Programm, indem Sie Zeichenfolgen eingeben und die EINGABETASTE drücken, und drücken Sie dann die EINGABETASTE, um das Programm zu beenden.

    Die Terminalausgabe sieht wie das folgende 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
    

Zusätzliche Ressourcen

Nächste Schritte

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

In diesem Tutorial erstellen Sie eine einfache Hilfsprogrammbibliothek, 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 6 ausgelegt ist, kann sie von jeder Anwendung aufgerufen werden, die auf .NET 6 ausgerichtet ist. In diesem Tutorial erfahren Sie, wie Sie .NET 6 als Ziel verwenden.

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

Voraussetzungen

Erstellen einer Projektmappe

Beginnen Sie, indem Sie eine leere Projektmappe erstellen, um das Klassenbibliotheksprojekt darin zu speichern. Eine Projektmappe dient als ein Container für mindestens ein Projekt. Sie fügen der gleichen Projektmappe weitere verwandte Projekte hinzu.

  1. Starten Sie Visual Studio Code.

  2. Wählen Sie im Hauptmenü Datei>Ordner öffnen (Öffnen... unter macOS) aus.

  3. Erstellen Sie im Dialogfeld Ordner öffnen den Ordner ClassLibraryProjects, und klicken Sie auf Ordner auswählen (Öffnen unter macOS).

  4. Öffnen Sie das Terminal in Visual Studio Code, indem Sie im Hauptmenü Ansicht>Terminal auswählen.

    Das Terminal wird mit der Eingabeaufforderung im Ordner ClassLibraryProjects geöffnet.

  5. Geben Sie im Terminal den folgenden Befehl ein:

    dotnet new sln
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Solution File" was created successfully.
    

Erstellen eines Klassenbibliotheksprojekts

Fügen Sie ein neues .NET-Klassenbibliotheksprojekt namens „StringLibrary“ zur Projektmappe hinzu.

  1. Führen Sie im Terminal den folgenden Befehl aus, um das Bibliotheksprojekt zu erstellen:

    dotnet new classlib -f net6.0 -o StringLibrary
    

    Der -f- oder --framework-Befehl ändert das Standardzielframework in net6.0-Version.

    Der Befehl -o oder --output gibt den Speicherort für die generierte Ausgabe an.

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Class library" was created successfully.
    Processing post-creation actions...
    Running 'dotnet restore' on StringLibrary\StringLibrary.csproj...
      Determining projects to restore...
      Restored C:\Projects\ClassLibraryProjects\StringLibrary\StringLibrary.csproj (in 328 ms).
    Restore succeeded.
    
  2. Führen Sie den folgenden Befehl aus, um das Bibliotheksprojekt zur Projektmappe hinzuzufügen:

    dotnet sln add StringLibrary/StringLibrary.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Project `StringLibrary\StringLibrary.csproj` added to the solution.
    
  3. Stellen Sie sicher, dass die Bibliothek auf .NET 6 ausgerichtet ist. Öffnen Sie im Explorer die Datei StringLibrary/StringLibrary.csproj.

    Das Element TargetFramework zeigt, dass das Projekt auf .NET 6.0 ausgerichtet ist.

    <Project Sdk="Microsoft.NET.Sdk">
    
      <PropertyGroup>
        <TargetFramework>net6.0</TargetFramework>
      </PropertyGroup>
    
    </Project>
    
  4. Öffnen Sie die Datei Class1.cs, und ersetzen Sie den Code durch den folgenden:

    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. Diese Methode gibt einen Boolean-Wert zurück, der angibt, ob die aktuelle Zeichenfolgeninstanz mit einem Großbuchstaben beginnt. Der Unicode-Standard unterscheidet Groß- und Kleinschreibung. 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.

  5. Speichern Sie die Datei.

  6. Führen Sie den folgenden Befehl aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt fehlerfrei kompiliert wird:

    dotnet build
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Microsoft (R) Build Engine version 16.7.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\net6.0\StringLibrary.dll
    Build succeeded.
        0 Warning(s)
        0 Error(s)
    Time Elapsed 00:00:02.78
    

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. Führen Sie im Terminal den folgenden Befehl aus, um das Konsolen-App-Projekt zu erstellen:

    dotnet new console -f net6.0 -o ShowCase
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    The template "Console Application" was created successfully.
    Processing post-creation actions...
    Running 'dotnet restore' on ShowCase\ShowCase.csproj...
      Determining projects to restore...
      Restored C:\Projects\ClassLibraryProjects\ShowCase\ShowCase.csproj (in 210 ms).
    Restore succeeded.
    
  2. Führen Sie den folgenden Befehl aus, um das Konsolen-App-Projekt zur Projektmappe hinzuzufügen:

    dotnet sln add ShowCase/ShowCase.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Project `ShowCase\ShowCase.csproj` added to the solution.
    
  3. Öffnen Sie die Datei ShowCase/Program.cs, und ersetzen Sie den gesamten Code durch den folgenden:

    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}");
                Console.WriteLine("Begins with uppercase? " +
                     $"{(input.StartsWithUpper() ? "Yes" : "No")}");
                Console.WriteLine();
                row += 4;
            } 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 sie mindestens 25 beträgt, löscht der Code das Konsolenfenster und zeigt eine Meldung für den Benutzer an.

    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.

  4. Speichern Sie die Änderungen.

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. Führen Sie den folgenden Befehl aus:

    dotnet add ShowCase/ShowCase.csproj reference StringLibrary/StringLibrary.csproj
    

    Die Terminalausgabe sieht wie das folgende Beispiel aus:

    Reference `..\StringLibrary\StringLibrary.csproj` added to the project.
    

Ausführen der App

  1. Führen Sie die folgenden Befehle im Terminal aus:

    dotnet run --project ShowCase/ShowCase.csproj
    
  2. Testen Sie das Programm, indem Sie Zeichenfolgen eingeben und die EINGABETASTE drücken, und drücken Sie dann die EINGABETASTE, um das Programm zu beenden.

    Die Terminalausgabe sieht wie das folgende 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
    

Zusätzliche Ressourcen

Nächste Schritte

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