Vorbereitung auf die Aufgabe

5 Minuten

Sie verwenden Visual Studio Code, um die C#-Konsolenanwendung von Contoso Pets für die Adoption von Haustieren zu aktualisieren. Die Anwendung erstellt bereits Beispieldaten zu Haustieren, die zur Adoption verfügbar sind, und kann Beschreibungen zum jeweiligen Haustier anzeigen. Die Anwendung ermöglicht die Suche mit einem einzelnen Begriff innerhalb der Beschreibungsdaten für alle Hunde. Das wichtigste Feature, das Sie hinzufügen sollen, ist die Möglichkeit der Suche mit mehreren Begriffen. Außerdem sollen Sie die Animation „Suchstatus“ verbessern und um einen Suchcountdown ergänzen.

Übersicht über die Projektspezifikation

Aktualisieren Sie die vorhandene Starteranwendung Contoso Pets so, dass sie mehrere Suchbegriffe zulässt, und verbessern Sie die Features der Animation „Suchstatus“:

Hinzufügen der Suche mit mehreren Begriffen nach Merkmalen von Hunden

Erfassen von Benutzereingaben für die Suche mit mehreren Begriffen nach Haustiermerkmalen

Die Benutzer*innen müssen die Suchbegriffe durch Kommas getrennt angeben.
Speichern Sie die Suchbegriffe in einem Array, und sortieren Sie die Begriffe alphabetisch.

Innerhalb einer Schleife im Haustierarray zum Ermitteln von Hunden:

Durchlaufen der Suchbegriffe für die Suchen in der Beschreibung der einzelnen Hunde
Suchen nach der kombinierten Beschreibung, die einem Suchbegriff entspricht
Ausgeben der Beschreibung aller Hunde, bei denen mindestens ein Begriff übereinstimmt

Nach Beendigung der Schleife für die Suche im Haustierarray zum Ermitteln von Hunden:

Ausgeben der Meldung no dogs matched (keine übereinstimmenden Hunde gefunden), wenn keine der von den Benutzer*innen angegebenen Suchbegriffe mit Hunden übereinstimmen

Verbessern der Animation „Suchstatus“

Aktualisieren der Animation

Anpassen des searchingIcons-Array, sodass es einem sich drehenden Zifferblatt ähnelt
Anpassen der Animationsschleife, sodass die Animation einen numerischen Countdown von zwei bis null 2.., 1.., 0.. anzeigt.

Startercode

Das Projekt mit dem Startercode für dieses Herausforderungsmodul enthält eine Datei „Program.cs“, die die folgenden Codefeatures bietet:

Der Code deklariert Variablen, die zum Erfassen und Verarbeiten von Haustierdaten und Menüelementauswahlen verwendet werden.
Der Code deklariert das ourAnimals-Array.
Der Code verwendet eine for-Schleife um ein if-elseif-else-Konstrukt, um das ourAnimals-Array mit einem Beispieldataset aufzufüllen.

Der Code zeigt die folgenden Hauptmenüoptionen für die Benutzerauswahl an:

1. List all of our current pet information
2. Display all dogs with a specified characteristic

Enter menu item selection or type "Exit" to exit the program

Der Code für das Anwendungsmenü analysiert die Menüelementauswahl der Benutzer*innen und zeigt eine Meldung an, in der die Auswahl genannt wird.
Fall 1: „List all of our current pet information“ (Alle aktuellen Haustierinformationen auflisten) zeigt Stichprobendaten für alle Haustiere (zwei Hunde und zwei Katzen) an.
Fall 2: „2. Display all dogs with a specified characteristic“ (Alle Hunde mit einem angegebenen Merkmal anzeigen) ist der primäre Bereich, in dem neuer Funktionscode hinzugefügt wird.
- Unter Fall 2 identifiziert der Startercode Hunde und sucht nach einem einzelnen Begriff aus der Benutzereingabe.
- Bevor Sie jeden Hund durchsuchen, wird an der Konsole eine einfache „Animation“ angezeigt, die den Status der aktuellen Suche simuliert.

Ihr Ziel ist es, den vorhandenen Code zu aktualisieren, um wichtige Features hinzuzufügen, die von Ihrem Team angefordert wurden:

Hinzufügen der Möglichkeit zur Suche nach Hunden mit mehreren Attributen
Aktualisieren der Suchanimation

Sie verwenden Visual Studio Code als Entwicklungsumgebung und testen Ihre Anwendung in jeder Phase des Entwicklungsprozesses.

Setup

Führen Sie die folgenden Schritte aus, um sich auf die Übungen des geführten Projekts vorzubereiten.

Laden Sie eine ZIP-Datei mit den Codeordnern für das Herausforderungsprojekt herunter.
- Öffnen Sie in einem Browser den Link Challenge-Project-variable-data-in-CSharp-main.zip, um die ZIP-Datei herunterzuladen (Challenge-Project-variable-data-in-CSharp-main.zip).
Entzippen Sie die heruntergeladenen Dateien lokal (oder in der Sandbox, wenn Sie keine lokale Entwicklungsumgebung verwenden).
1. Navigieren Sie auf Ihrem lokalen Computer zu Ihrem Downloadordner.
2. Klicken Sie mit der rechten Maustaste auf die Datei „Challenge-Project-variable-data-in-CSharp-main.zip“, und wählen Sie dann Alle extrahieren aus.
3. Notieren Sie sich den Speicherort der extrahierten Dateien (den Stammordner).
Öffnen Sie den neuen Ordner „GuidedProject“ in Visual Studio Code.
1. Öffnen Sie Visual Studio Code lokal, oder öffnen Sie alternativ die MS Learn-Sandbox und dort Visual Studio Code, wenn Sie keine lokale Entwicklungsumgebung verwenden.
2. Wählen Sie in Visual Studio Code im Menü Datei die Option Ordner öffnen aus.
3. Navigieren Sie zum Ordner mit den extrahierten Dateien, und klappen Sie die Ordnerstruktur auf, um zum Ordner „Challenge-Project-variable-data-in-CSharp-main“ zu wechseln.
4. Wählen Sie Challenge-Project-variable-data-in-CSharp-main und dann Ordner auswählen aus.
  - In der EXPLORER-Ansicht von Visual Studio Code sollten die beiden Unterordner Final und Starter zu sehen sein.

Überprüfen der Starterdatei

Navigieren Sie in Visual Studio Code zum Ordner starter des Herausforderungsprojekts.
Wählen Sie in Visual Studio Code auf der Menüleiste „Terminal“ > „Neues Terminal“ aus.
Das Terminalfenster sollte im Ordner „starter“ geöffnet werden, der die Datei „Program.cs“ enthält. Erstellen Sie die Datei, und führen Sie sie aus, indem Sie im Terminalfenster dotnet run eingeben.

Im Menü sollten zwei Optionen angezeigt werden. Geben Sie wie im folgenden Terminalbeispiel gezeigt 1 ein:

Welcome to the Contoso PetFriends app. Your main menu options are:
  1. List all of our current pet information
  2. Display all dogs with a specified characteristic

Enter your selection number (or type Exit to exit the program)
1

Es sollten Beispieldaten zu den aktuellen Haustieren gefolgt von der Meldung Press the Enter key to continue angezeigt werden.

Nach Drücken der EINGABETASTE sollte das Menü erneut angezeigt werden. Wählen Sie Option 2 aus, die im folgenden Beispiel gezeigt wird:

Welcome to the Contoso PetFriends app. Your main menu options are:
 1. List all of our current pet information
 2. Display all dogs with a specified characteristic

Enter your selection number (or type Exit to exit the program)
2

Enter one desired dog characteristic to search for

Geben Sie als Suchbegriff „large“ (groß) ein, und drücken Sie die EINGABETASTE.
Beachten Sie die angezeigte Meldung zur Suche („searching ...“):
```
searching our dog Nickname: gus for large ...     
```
Beachten Sie, dass die Nachricht vor jeder Suche eines Haustiers angezeigt wird, und beachten Sie auch, dass sich die Punkte (., .., ...) am Ende in einer Animation ändern. Führen Sie die Suche erneut aus, wenn es Ihnen nicht aufgefallen ist.
Drücken Sie nach Abschluss der Suche die EINGABETASTE, um zum Menü zurückzukehren. Geben Sie dann „exit“ ein, und drücken Sie die EINGABETASTE, um die Anwendung zu schließen.
Nehmen Sie sich etwas Zeit, um sich mit dem Code in der Datei „Project.cs“ vertraut zu machen.

Konzentrieren Sie sich auf die Bereiche, die Sie aktualisieren sollen: die Suche und die Animation.

Beachten Sie, dass im Code einige Kommentare enthalten sind, die angeben, wo Änderungen vorgenommen werden sollen.

Sie können jetzt mit den Übungen des geführten Projekts beginnen. Viel Glück!