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
Visual Studio Code mit installierter C#-Erweiterung.
Wenn Sie die C#-Entwicklerkit-Erweiterung installiert haben, deinstallieren oder deaktivieren Sie sie. Sie wird in dieser Tutorialreihe nicht verwendet.
Informationen zum Installieren von Erweiterungen für Visual Studio Code finden Sie unter Marketplace für VS Code-Erweiterungen.
Das .NET 8 SDK.
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.
Starten Sie Visual Studio Code.
Wählen Sie im Hauptmenü Datei>Ordner öffnen (Öffnen... unter macOS) aus.
Erstellen Sie im Dialogfeld Ordner öffnen den Ordner ClassLibraryProjects, und klicken Sie auf Ordner auswählen (Öffnen unter macOS).
Ö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.
Geben Sie im Terminal den folgenden Befehl ein:
dotnet new slnDie 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.
Führen Sie im Terminal den folgenden Befehl aus, um das Bibliotheksprojekt zu erstellen:
dotnet new classlib -o StringLibraryDer Befehl
-ooder--outputgibt 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.Führen Sie den folgenden Befehl aus, um das Bibliotheksprojekt zur Projektmappe hinzuzufügen:
dotnet sln add StringLibrary/StringLibrary.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Project `StringLibrary\StringLibrary.csproj` added to the solution.Stellen Sie sicher, dass die Bibliothek auf .NET 8 als Ziel hat. Öffnen Sie im Explorer die Datei StringLibrary/StringLibrary.csproj.
Das Element
TargetFrameworkgibt an, dass das Projekt .NET 8.0 als Ziel hat.<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net8.0</TargetFramework> </PropertyGroup> </Project>Ö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 namensStartsWithUpper. 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) gibttruezurück, wenn ein Zeichen ein Großbuchstabe ist.Die Methode
StartsWithUpperwird als Erweiterungsmethode implementiert, damit sie wie ein Member der Klasse String aufgerufen werden kann.Speichern Sie die Datei.
Führen Sie den folgenden Befehl aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt fehlerfrei kompiliert wird:
dotnet buildDie 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.
Führen Sie im Terminal den folgenden Befehl aus, um das Konsolen-App-Projekt zu erstellen:
dotnet new console -o ShowCaseDie 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.Führen Sie den folgenden Befehl aus, um das Konsolen-App-Projekt zur Projektmappe hinzuzufügen:
dotnet sln add ShowCase/ShowCase.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Project `ShowCase\ShowCase.csproj` added to the solution.Ö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.
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.
Führen Sie den folgenden Befehl aus:
dotnet add ShowCase/ShowCase.csproj reference StringLibrary/StringLibrary.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Reference `..\StringLibrary\StringLibrary.csproj` added to the project.
Ausführen der App
Führen Sie die folgenden Befehle im Terminal aus:
dotnet run --project ShowCase/ShowCase.csprojTesten 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
- Entwickeln von Bibliotheken mit der .NET-CLI
- .NET Standard-Versionen und die von ihnen unterstützten Plattformen.
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
- Visual Studio Code mit installierter C#-Erweiterung. Informationen zum Installieren von Erweiterungen für Visual Studio Code finden Sie unter Marketplace für VS Code-Erweiterungen.
- Das .NET 7 SDK.
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.
Starten Sie Visual Studio Code.
Wählen Sie im Hauptmenü Datei>Ordner öffnen (Öffnen... unter macOS) aus.
Erstellen Sie im Dialogfeld Ordner öffnen den Ordner ClassLibraryProjects, und klicken Sie auf Ordner auswählen (Öffnen unter macOS).
Ö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.
Geben Sie im Terminal den folgenden Befehl ein:
dotnet new slnDie 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.
Führen Sie im Terminal den folgenden Befehl aus, um das Bibliotheksprojekt zu erstellen:
dotnet new classlib -o StringLibraryDer Befehl
-ooder--outputgibt 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.Führen Sie den folgenden Befehl aus, um das Bibliotheksprojekt zur Projektmappe hinzuzufügen:
dotnet sln add StringLibrary/StringLibrary.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Project `StringLibrary\StringLibrary.csproj` added to the solution.Stellen Sie sicher, dass die Bibliothek .NET 7 als Ziel hat. Öffnen Sie im Explorer die Datei StringLibrary/StringLibrary.csproj.
Das Element
TargetFrameworkgibt an, dass das Projekt .NET 7.0 als Ziel hat.<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net7.0</TargetFramework> </PropertyGroup> </Project>Ö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 namensStartsWithUpper. 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) gibttruezurück, wenn ein Zeichen ein Großbuchstabe ist.Die Methode
StartsWithUpperwird als Erweiterungsmethode implementiert, damit sie wie ein Member der Klasse String aufgerufen werden kann.Speichern Sie die Datei.
Führen Sie den folgenden Befehl aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt fehlerfrei kompiliert wird:
dotnet buildDie 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.
Führen Sie im Terminal den folgenden Befehl aus, um das Konsolen-App-Projekt zu erstellen:
dotnet new console -o ShowCaseDie 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.Führen Sie den folgenden Befehl aus, um das Konsolen-App-Projekt zur Projektmappe hinzuzufügen:
dotnet sln add ShowCase/ShowCase.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Project `ShowCase\ShowCase.csproj` added to the solution.Ö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.
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.
Führen Sie den folgenden Befehl aus:
dotnet add ShowCase/ShowCase.csproj reference StringLibrary/StringLibrary.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Reference `..\StringLibrary\StringLibrary.csproj` added to the project.
Ausführen der App
Führen Sie die folgenden Befehle im Terminal aus:
dotnet run --project ShowCase/ShowCase.csprojTesten 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
- Entwickeln von Bibliotheken mit der .NET-CLI
- .NET Standard-Versionen und die von ihnen unterstützten Plattformen.
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
- Visual Studio Code mit installierter C#-Erweiterung. Informationen zum Installieren von Erweiterungen für Visual Studio Code finden Sie unter Marketplace für VS Code-Erweiterungen.
- Das .NET 6 SDK.
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.
Starten Sie Visual Studio Code.
Wählen Sie im Hauptmenü Datei>Ordner öffnen (Öffnen... unter macOS) aus.
Erstellen Sie im Dialogfeld Ordner öffnen den Ordner ClassLibraryProjects, und klicken Sie auf Ordner auswählen (Öffnen unter macOS).
Ö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.
Geben Sie im Terminal den folgenden Befehl ein:
dotnet new slnDie 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.
Führen Sie im Terminal den folgenden Befehl aus, um das Bibliotheksprojekt zu erstellen:
dotnet new classlib -f net6.0 -o StringLibraryDer
-f- oder--framework-Befehl ändert das Standardzielframework innet6.0-Version.Der Befehl
-ooder--outputgibt 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.Führen Sie den folgenden Befehl aus, um das Bibliotheksprojekt zur Projektmappe hinzuzufügen:
dotnet sln add StringLibrary/StringLibrary.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Project `StringLibrary\StringLibrary.csproj` added to the solution.Stellen Sie sicher, dass die Bibliothek auf .NET 6 ausgerichtet ist. Öffnen Sie im Explorer die Datei StringLibrary/StringLibrary.csproj.
Das Element
TargetFrameworkzeigt, dass das Projekt auf .NET 6.0 ausgerichtet ist.<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net6.0</TargetFramework> </PropertyGroup> </Project>Ö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 namensStartsWithUpper. 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) gibttruezurück, wenn ein Zeichen ein Großbuchstabe ist.Die Methode
StartsWithUpperwird als Erweiterungsmethode implementiert, damit sie wie ein Member der Klasse String aufgerufen werden kann.Speichern Sie die Datei.
Führen Sie den folgenden Befehl aus, um die Projektmappe zu erstellen und zu überprüfen, ob das Projekt fehlerfrei kompiliert wird:
dotnet buildDie 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.
Führen Sie im Terminal den folgenden Befehl aus, um das Konsolen-App-Projekt zu erstellen:
dotnet new console -f net6.0 -o ShowCaseDie 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.Führen Sie den folgenden Befehl aus, um das Konsolen-App-Projekt zur Projektmappe hinzuzufügen:
dotnet sln add ShowCase/ShowCase.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Project `ShowCase\ShowCase.csproj` added to the solution.Ö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.
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.
Führen Sie den folgenden Befehl aus:
dotnet add ShowCase/ShowCase.csproj reference StringLibrary/StringLibrary.csprojDie Terminalausgabe sieht wie das folgende Beispiel aus:
Reference `..\StringLibrary\StringLibrary.csproj` added to the project.
Ausführen der App
Führen Sie die folgenden Befehle im Terminal aus:
dotnet run --project ShowCase/ShowCase.csprojTesten 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
- Entwickeln von Bibliotheken mit der .NET-CLI
- .NET Standard-Versionen und die von ihnen unterstützten Plattformen.
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.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für