Freigeben über


Lernprogramm: Erstellen Ihrer ersten Universellen Windows-Plattform-Anwendung in Visual Studio mit XAML und C#

In diesem Lernprogramm erstellen Sie als Einführung in die integrierte Entwicklungsumgebung (Integrated Development Environment, IDE) von Visual Studio eine "Hello World"-App, die auf einem beliebigen Windows 10- oder höher-Gerät ausgeführt wird. Dazu verwenden Sie eine UWP-Projektvorlage (Universelle Windows-Plattform), extensible Application Markup Language (XAML) und die C#-Programmiersprache.

Anmerkung

Wenn Sie mit Ihrer aktuellen Funktionalität in der Universellen Windows-Plattform (UWP) zufrieden sind, müssen Sie Ihren Projekttyp nicht zum Windows App SDK migrieren. WinUI 2.x und das Windows SDK unterstützen UWP-Projekttypen. Wenn Sie mit WinUI 3 und Windows App SDK beginnen möchten, können Sie die Schritte im Windows App SDK-Lernprogrammausführen.

In diesem Tutorial:

  • Erstellen eines Projekts
  • Erstellen einer Anwendung
  • Ausführen der Anwendung

Voraussetzungen

Sie benötigen Visual Studio, um dieses Lernprogramm abzuschließen. Besuchen Sie die Visual Studio-Downloadseite für eine kostenlose Version.

Anmerkung

Dieses Tutorial erfordert die Projektvorlage Leere App (Universal Windows). Wählen Sie während der Installation die Workload Entwicklung der Universellen Windows-Plattform aus:

Screenshot des Visual Studio-Installers mit dem Workload 'Universelle Windows-Plattform Entwicklung'.

Wenn Sie Visual Studio bereits installiert haben und sie hinzufügen müssen, wählen Sie im Menü Tools>Tools und Features abrufenaus, oder wählen Sie im Fenster Erstellen eines neuen Projekts den Link Weitere Tools und Features installieren Link aus.

Screenshot des Fensters

Erstellen eines Projekts

Erstellen Sie zunächst ein Projekt für die universelle Windows-Plattform. Der Projekttyp enthält alle benötigten Vorlagendateien, bevor Sie sogar etwas hinzufügen!

  1. Öffnen Sie Visual Studio, und wählen Sie im Startfenster Erstellen eines neuen Projektsaus.

  2. Geben Sie auf dem Bildschirm Erstellen eines neuen Projekts im Suchfeld Universal Windows ein, wählen Sie die C#-Vorlage für Leere App (Universal Windows)aus, und wählen Sie dann Weiteraus.

    Screenshot: Dialogfeld „Neues Projekt erstellen“ mit Eingabe „Universal Windows“ im Suchfeld und der hervorgehobenen Projektvorlage „Leere App (Universal Windows)“

  3. Geben Sie dem Projekt einen Namen, HelloWorld, und wählen Sie Erstellenaus.

    Screenshot des Dialogfelds

  4. Übernehmen Sie die Standardeinstellungen für die Zielversion und die Mindestversion im Dialogfeld Neues Projekt für die universelle Windows-Plattform.

    Screenshot des Dialogfelds

    Anmerkung

    Wenn Sie Visual Studio zum ersten Mal zum Erstellen einer UWP-App verwendet haben, wird möglicherweise ein dialogfeld Einstellungen angezeigt. Wählen Sie Entwicklermodusaus, und wählen Sie dann Jaaus.

    Screenshot mit dem Dialogfeld

    Visual Studio installiert ein zusätzliches Entwicklermoduspaket für Sie. Schließen Sie nach Abschluss der Paketinstallation das Dialogfeld Einstellungen.

  1. Öffnen Sie Visual Studio, und wählen Sie im Startfenster Erstellen eines neuen Projektsaus.

  2. Geben Sie auf dem Bildschirm Erstellen eines neuen Projekts im Suchfeld Universal Windows ein, wählen Sie die C#-Vorlage für Leere App (Universal Windows)aus, und wählen Sie dann Weiteraus.

    Screenshot: Dialogfeld „Neues Projekt erstellen“ mit Eingabe „Universal Windows“ im Suchfeld und der hervorgehobenen Projektvorlage „Leere App (Universal Windows)“

  3. Geben Sie dem Projekt einen Namen, HelloWorld, und wählen Sie Erstellenaus.

    Screenshot des Dialogfelds

  4. Übernehmen Sie im Dialogfeld Neues UWP-Projekt die Standardeinstellungen für Zielversion und Mindestversion.

    Screenshot des Dialogfelds

    Anmerkung

    Wenn Sie Visual Studio zum ersten Mal zum Erstellen einer UWP-App verwendet haben, wird das Dialogfeld Entwicklermodus für Windows aktivieren angezeigt. Wählen Sie Einstellungen für Entwickler aus, um die Einstellungen zu öffnen. Aktivieren Sie Entwicklermodus, und wählen Sie dann Jaaus.

    Screenshot mit dem Dialogfeld

    Visual Studio installiert ein zusätzliches Entwicklermoduspaket für Sie. Schließen Sie nach Abschluss der Paketinstallation das Dialogfeld Einstellungen.

Erstellen der Anwendung

Es ist an der Zeit, mit der Entwicklung zu beginnen. Fügen Sie ein Schaltflächensteuerelement hinzu, fügen Sie der Schaltfläche eine Aktion hinzu, und starten Sie dann die App "Hello World", um zu sehen, wie sie aussieht.

Hinzufügen einer Schaltfläche zum Entwurfsbereich

  1. Doppelklicken Sie im Projektmappen-Explorerauf MainPage.xaml, um eine geteilte Ansicht zu öffnen.

    Screenshot des Fensters

    Es gibt zwei Bereiche: die XAML-Designer-, die einen Entwurfsbereich enthält, und den XAML-Editor, in dem Sie Code hinzufügen oder ändern können.

    Screenshot mit

  2. Klicken Sie auf Toolbox, um das Toolbox-Flyoutfenster zu öffnen.

    Screenshot: Registerkarte für hervorgehobenes Flyoutfenster „Toolbox“ auf der linken Seite des XAML-Designer-Bereichs

    Wenn die Option Toolbox nicht angezeigt wird, können Sie sie über die Menüleiste öffnen. Hierzu wählen Sie Ansicht>Symbolleiste aus. Oder drücken Sie STRG+ALT-+X-.

  3. Wählen Sie das Symbol Pin aus, um das Fenster der Toolbox zu verankern.

    Screenshot: hervorgehobenes Stecknadelsymbol in der oberen Leiste des Fensters „Toolbox“

  4. Wählen Sie das Steuerelement Schaltfläche aus, und ziehen Sie es in die Entwurfs-Canvas.

    Screenshot: Hervorgehobene Option „Schaltfläche“ im Fenster „Toolbox“ und ein Button-Steuerelement in der Entwurfs-Canvas

    Wenn Sie den Code im XAML-Editor-betrachten, sehen Sie, dass auch dort die -Schaltfläche angezeigt wird:

    Screenshot mit dem Code für die neu hinzugefügte Schaltfläche, hervorgehoben im XAML-Editor.

  1. Doppelklicken Sie im Projektmappen-Explorerauf MainPage.xaml, um eine geteilte Ansicht zu öffnen.

    Screenshot: Fenster „Projektmappen-Explorer“ mit den Eigenschaften, Verweisen, Ressourcen und Dateien des HelloWorld-Projekts und ausgewählter Datei „MainPage.xaml“

    Es gibt zwei Bereiche: die XAML-Designer-, die einen Entwurfsbereich enthält, und den XAML-Editor, in dem Sie Code hinzufügen oder ändern können.

    Screenshot mit

  2. Klicken Sie auf Toolbox, um das Toolbox-Flyoutfenster zu öffnen.

    Screenshot: Registerkarte für hervorgehobenes Flyoutfenster „Toolbox“ auf der linken Seite des XAML-Designer-Bereichs

    Wenn die Option Toolbox nicht angezeigt wird, können Sie sie über die Menüleiste öffnen. Hierzu wählen Sie Ansicht>Symbolleiste aus. Oder drücken Sie STRG+ALT-+X-.

  3. Wählen Sie das Stecknadelsymbol aus, um das Fenster „Toolbox“ anzudocken.

    Screenshot: hervorgehobenes Stecknadelsymbol in der oberen Leiste des Fensters „Toolbox“

  4. Wählen Sie das Steuerelement Schaltfläche aus, und ziehen Sie es in die Entwurfs-Canvas.

    Screenshot: Hervorgehobene Option „Schaltfläche“ im Fenster „Toolbox“ und ein Button-Steuerelement in der Entwurfs-Canvas

    Wenn Sie den Code im XAML-Editor-betrachten, sehen Sie auch, dass die Schaltfläche dort angezeigt wird:

    Screenshot, der den Code für die neu hinzugefügte Schaltfläche im XAML-Editor hervorhebt.

Hinzufügen einer Beschriftung zur Schaltfläche

  1. Im XAML-Editorden Wert Button Content von Button zu Hello World! ändern.

    Screenshot mit dem XAML-Code für die Schaltfläche im XAML-Editor, wobei die Inhaltseigenschaft in Hello World geändert wurde!

  2. Beachten Sie, dass sich die Schaltfläche im XAML-Designer auch ändert.

    Screenshot: Schaltfläche-Steuerelement auf der Canvas des XAML-Designers, die Bezeichnung der Schaltfläche wurde in „Hallo Welt“ geändert

  1. Ändern Sie im XAML-Editorden Button Content Wert von Button zu Hello World!.

    Screenshot mit dem XAML-Code für die Schaltfläche im XAML-Editor, wobei der Wert der Inhaltseigenschaft auf

  2. Beachten Sie, dass sich die Schaltfläche im XAML-Designer ebenfalls ändert.

    Screenshot mit dem Schaltflächen-Steuerelement auf der Leinwand des XAML-Designers, bei dem die Beschriftung der Schaltfläche in

Hinzufügen eines Ereignishandlers

Ein Ereignishandler klingt kompliziert, ist aber nur ein anderer Name für Code, der aufgerufen wird, wenn ein Ereignis eintritt. In diesem Fall wird der Schaltfläche Hello World! eine Aktion hinzugefügt.

  1. Doppelklicken Sie auf der Entwurfs-Canvas auf das Steuerelement „Schaltfläche“.

  2. Bearbeiten Sie den Ereignishandlercode in MainPage.Xaml.cs, der CodeBehind-Seite.

    Hier finden Sie interessante Dinge. Der Standardereignishandler sieht wie folgt aus:

    Screenshot mit dem C#-Code für den Standardereignishandler Button_Click.

    Ändern Sie sie, sodass sie wie folgt aussieht:

    Screenshot mit dem C#-Code für den neuen asynchronen Button_Click Ereignishandler.

    Hier sehen Sie den Code zum Kopieren und Einfügen:

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
       MediaElement mediaElement = new MediaElement();
       var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
       Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
       mediaElement.SetSource(stream, stream.ContentType);
       mediaElement.Play();
    }
    
  1. Doppelklicken Sie auf der Entwurfs-Canvas auf das Steuerelement „Schaltfläche“.

  2. Bearbeiten Sie den Ereignishandlercode in MainPage.Xaml.cs, der CodeBehind-Seite.

    Hier finden Sie interessante Dinge. Der Standardereignishandler sieht wie folgt aus:

    Screenshot mit dem C#-Code für den Standardereignishandler Button_Click.

    Ändern Sie sie, sodass sie wie folgt aussieht:

    Screenshot mit dem C#-Code für den neuen asynchronen Button_Click Ereignishandler.

    Hier sehen Sie den Code zum Kopieren und Einfügen:

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
       MediaElement mediaElement = new MediaElement();
       var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
       Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
       mediaElement.SetSource(stream, stream.ContentType);
       mediaElement.Play();
    }
    

Was haben wir gerade getan?

Der Code verwendet einige Windows-APIs zum Erstellen eines Sprachsyntheseobjekts und gibt ihr dann Text. Weitere Informationen zur Verwendung von SpeechSynthesisfinden Sie unter System.Speech.Synthesis.

Ausführen der Anwendung

Es ist an der Zeit, die UWP-App "Hello World" zu erstellen, bereitzustellen und zu starten, um zu sehen, wie sie aussieht und klingt. Gehen Sie dazu wie folgt vor:

  1. Verwenden Sie die Schaltfläche "Play", um die Anwendung auf dem lokalen Rechner zu starten. Es enthält den Text Lokaler Computer.

    Screenshot mit geöffnetem Dropdownfeld neben der Schaltfläche

    Alternativ können Sie auf der Menüleiste Debuggen>Debuggen starten auswählen oder F5- drücken, um die App zu starten.

  2. Sehen Sie sich Ihre App an, die gleich nach der Anzeige eines Begrüßungsbildschirms angezeigt wird. Die App sollte ähnlich wie in dieser Abbildung aussehen:

    Screenshot der ausgeführten UWP-Anwendung

  3. Wählen Sie die Schaltfläche Hello World aus.

    Ihr Windows 10- oder höher-Gerät sagt wörtlich: "Hello, World!"

  4. Um die App zu schließen, wählen Sie in der Symbolleiste die Schaltfläche Debuggen beenden aus. Alternativ können Sie in der Menüleiste auf Debuggen>Debuggen beenden auswählen oder UMSCHALTTASTE+F5 drücken.

Es ist an der Zeit, die UWP-App "Hello World" zu erstellen, bereitzustellen und zu starten, um zu sehen, wie sie aussieht und klingt. Gehen Sie dazu wie folgt vor:

  1. Verwenden Sie die Schaltfläche "Start" (sie hat den Text Lokaler Computer), um die Anwendung auf dem lokalen Computer zu starten.

    Screenshot mit geöffnetem Dropdownfeld neben der Schaltfläche

    Alternativ können Sie auf der Menüleiste Debuggen>Debuggen starten auswählen oder F5- drücken, um die App zu starten.

  2. Sehen Sie Ihre App, die kurz nachdem der Begrüßungsbildschirm verschwindet, erscheint. Die App sollte ähnlich wie dieses Bild aussehen:

    Screenshot der ausgeführten UWP-Anwendung

  3. Wählen Sie die Schaltfläche Hello World aus.

    Ihr Windows 10- oder höher-Gerät sagt wörtlich: "Hello, World!"

  4. Um die App zu schließen, wählen Sie in der Symbolleiste die Schaltfläche Debuggen beenden aus. Alternativ können Sie in der Menüleiste auf Debuggen>Debuggen beenden auswählen oder UMSCHALTTASTE+F5 drücken.

Nächster Schritt

Herzlichen Glückwunsch zum Abschluss dieses Lernprogramms! Wir hoffen, dass Sie einige Grundlagen zu UWP und der Visual Studio-IDE kennengelernt haben. Fahren Sie für weitere Informationen mit dem folgenden Tutorial fort: