Freigeben über


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

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

Anmerkung

WinUI 3 ist die systemeigene Ui-Plattformkomponente, die im Windows App SDK enthalten ist. Es wird vollständig von Windows-SDKs entkoppelt. Weitere Informationen finden Sie unter WinUI 3.

Voraussetzungen

  • Sie benötigen Visual Studio 2026 oder die neueste Version von Visual Studio 2022, um dieses Lernprogramm abzuschließen. Eine kostenlose Version finden Sie unter Visual Studio-Downloads.
  • Workloads und Komponenten, die für die Entwicklung mit WinUI und dem Windows App SDK erforderlich sind. Um eine Workload in Visual Studio zu überprüfen oder zu installieren, wählen Sie Extras>Extras und Features abrufen aus. Weitere Informationen finden Sie unter Ändern von Workloads oder einzelnen Komponenten.

Wählen Sie auf der Registerkarte "Workloads " des Visual Studio-Installers Folgendes aus:

Wählen Sie für die C# -App-Entwicklung mit dem Windows App SDK die WinUI-Anwendungsentwicklung aus.

Wählen Sie für die C# -App-Entwicklung mit dem Windows App SDK die WinUI-Anwendungsentwicklung aus.

Anmerkung

In Visual Studio 17.10 - 17.12 wird diese Workload als Windows-Anwendungsentwicklung bezeichnet.

Ausführliche Informationen finden Sie unter Installieren von Tools für das Windows App SDK.

Erstellen eines Projekts

Erstellen Sie zunächst ein WinUI 3-Projekt. 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 " Neues Projekt erstellen " WinUI in das Suchfeld ein, wählen Sie die C#-Vorlage für "Leere WinUI-App (Verpackt)" aus, und wählen Sie dann "Weiter" aus.

    Screenshot des Dialogfelds

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

    Screenshot des Dialogfelds

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

  2. Geben Sie auf dem Bildschirm " Neues Projekt erstellen " winui in das Suchfeld ein, wählen Sie die C#-Vorlage für die Vorlage "C#" für "Leere App", "Verpackt" (WinUI 3 in Desktop) und dann " Weiter" aus.

    Screenshot des Dialogfelds

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

    Screenshot des Dialogfelds

Anmerkung

Wenn Sie Visual Studio zum ersten Mal verwenden, um eine Windows App SDK-App zu erstellen, wird möglicherweise ein Dialogfeld "Einstellungen" angezeigt. Wählen Sie Entwicklermodusaus, und wählen Sie dann Jaaus.

Screenshot des Dialogfelds

Visual Studio installiert ein weiteres Entwicklermoduspaket für Sie. Wenn die Paketinstallation abgeschlossen ist, schließen Sie das Dialogfeld "Einstellungen ".

Erstellen der Anwendung

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

Hinzufügen einer Schaltfläche zum Entwurfsbereich

  1. Doppelklicken Sie im Solution Explorerauf MainWindow.xaml, um den XAML-Markup-Editor zu öffnen.

    Screenshot des Projektmappen-Explorer-Fensters mit den Eigenschaften, Verweisen, Ressourcen und Dateien im HelloWorld-Projekt, wobei die Datei

    Mit dem XAML-Editor- können Sie Markup hinzufügen oder ändern. Im Gegensatz zu UWP-Projekten bietet WinUI 3 keine Designansicht.

    Screenshot mit

  2. Beginnen Sie innerhalb des Elements mit der <Grid> Eingabe <Button. IntelliSense bietet Ihnen eine Schaltflächenoption. Drücken Sie die TAB-TASTE , um dies zu akzeptieren.

    Screenshot mit hervorgehobener Schaltfläche im XAML-Editor.

  1. Doppelklicken Sie im Solution Explorerauf MainWindow.xaml, um den XAML-Markup-Editor zu öffnen.

    Screenshot des Projektmappen-Explorer-Fensters in Visual Studio 2022 mit den Eigenschaften, Verweisen, Ressourcen und Dateien im HelloWorld-Projekt, wobei die Datei

    Mit dem XAML-Editor- können Sie Markup hinzufügen oder ändern. Im Gegensatz zu UWP-Projekten bietet WinUI 3 keine Designansicht.

    Screenshot, in dem

  2. Sehen Sie sich das Schaltflächen-Steuerelement an, das in StackPanel im Stammverzeichnis von Window geschachtelt ist.

    Screenshot mit hervorgehobener Schaltfläche im XAML-Editor.

Ändern der Beschriftung auf der Schaltfläche

  1. Ändern Sie im XAML-Editor den Wert "Schaltflächeninhalt" von ihrem aktuellen Wert in "Hello World!".

    Screenshot des XAML-Codes für die Schaltfläche im XAML-Editor, wobei der Wert der Inhaltseigenschaft in Hello World geändert wurde!

  2. Platzieren Sie den Cursor im Starttag des <Button> Elements (nach den vorhandenen Attributen, z. B. Content) und beginnen Sie mit der Eingabe Click. IntelliSense bietet einen neuen Ereignishandler namens Button_Click. Sie arbeiten mit diesem Code im nächsten Abschnitt.

    Screenshot des XAML-Codes für die Schaltfläche im XAML-Editor mit hervorgehobenen Klickereignissen der Schaltfläche.

  1. Ändern Sie im XAML-Editor den Wert "Schaltflächeninhalt" von ihrem aktuellen Wert in "Hello World!".

    Screenshot des XAML-Codes für die Schaltfläche im XAML-Editor in Visual Studio 2022, wobei der Wert der Inhaltseigenschaft in Hello World geändert wurde!

  2. Beachten Sie, dass für die Schaltfläche auch ein Click-Ereignishandler mit dem Namen myButton_Click angegeben ist. Sie arbeiten damit im nächsten Schritt.

    Screenshot des XAML-Codes für die Schaltfläche im XAML-Editor in Visual Studio 2022 mit hervorgehobenen Click-Ereignis der Schaltfläche.

Ändern des Ereignishandlers

Ein Ereignishandler klingt kompliziert, aber es ist nur ein anderer Name für Code, der aufgerufen wird, wenn ein Ereignis auftritt. In diesem Fall wird eine Aktion hinzugefügt, die von der Hello World ausgelöst wird! aus.

  1. Doppelklicken Sie im Projektmappen-Explorer auf MainWindow.xaml.cs, die CodeBehind-Seite.

  2. Bearbeiten Sie den Ereignishandlercode im daraufhin geöffneten C#-Editorfenster.

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

    Screenshot des C#-Codes für den Standardereignishandler Button_Click.

    Lassen Sie uns es ändern, sodass es wie folgt aussieht:

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

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

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = ((FrameworkElement)sender).XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    
  1. Doppelklicken Sie im Projektmappen-Explorer auf MainWindow.xaml.cs, die CodeBehind-Seite.

  2. Bearbeiten Sie den Ereignishandlercode im daraufhin geöffneten C#-Editorfenster.

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

    Screenshot des C#-Codes für den Standardereignishandler Button_Click in Visual Studio 2022.

    Lassen Sie uns es ändern, sodass es wie folgt aussieht:

    Screenshot des C#-Codes für den neuen asynchronen myButton_Click-Ereignishandler in Visual Studio 2022.

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

    private async void myButton_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = myButton.XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    

Was haben wir gerade getan?

Der Code verwendet das ContentDialog Steuerelement, um eine Willkommensnachricht in einem modalen Popupsteuerelement im aktuellen Fenster anzuzeigen. Weitere Informationen zur Verwendung Microsoft.UI.Xaml.Controls.ContentDialogfinden Sie unter ContentDialog-Klasse.

Ausführen der Anwendung

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

  1. Verwenden Sie die Schaltfläche "Start", um die Anwendung auf dem lokalen Rechner zu starten. Es enthält den Text HelloWorld (Package).

    Screenshot, in dem das Dropdownfeld neben der Schaltfläche

    Alternativ können Sie " Debuggen>starten" in der Menüleiste 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 dieses Bild aussehen:

    Screenshot der ausgeführten Windows App SDK -Anwendung

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

    Ihr Windows 10- oder höher-Gerät zeigt eine Meldung mit der Meldung "Willkommen bei Ihrer ersten Windows App SDK-App" mit dem Titel "Hello from HelloWorld" an. Wählen Sie "OK" aus, um die Nachricht zu schließen.

    Screenshot mit der ausgeführten

  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 " Debuggen>beenden" auswählen oder UMSCHALT+F5 drücken.

Herzlichen Glückwunsch zum Abschluss dieses Lernprogramms! Wir hoffen, dass Sie einige Grundlagen zum Windows App SDK, WinUI 3 und zur Visual Studio-IDE gelernt haben. Um mehr zu erfahren, fahren Sie mit dem folgenden Tutorial fort:

Diese Ressourcen können auch nützlich sein: