Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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!
Öffnen Sie Visual Studio, und wählen Sie im Startfenster Erstellen eines neuen Projektsaus.
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.
Geben Sie dem Projekt einen Namen, HelloWorld, und wählen Sie Erstellenaus.
Öffnen Sie Visual Studio, und wählen Sie im Startfenster Erstellen eines neuen Projektsaus.
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.
Geben Sie dem Projekt einen Namen, HelloWorld, und wählen Sie Erstellenaus.
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.
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
Doppelklicken Sie im Solution Explorerauf MainWindow.xaml, um den XAML-Markup-Editor zu öffnen.
Mit dem XAML-Editor- können Sie Markup hinzufügen oder ändern. Im Gegensatz zu UWP-Projekten bietet WinUI 3 keine Designansicht.
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.
Doppelklicken Sie im Solution Explorerauf MainWindow.xaml, um den XAML-Markup-Editor zu öffnen.
Mit dem XAML-Editor- können Sie Markup hinzufügen oder ändern. Im Gegensatz zu UWP-Projekten bietet WinUI 3 keine Designansicht.
Sehen Sie sich das Schaltflächen-Steuerelement an, das in StackPanel im Stammverzeichnis von Window geschachtelt ist.
Ändern der Beschriftung auf der Schaltfläche
Ändern Sie im XAML-Editor den Wert "Schaltflächeninhalt" von ihrem aktuellen Wert in "Hello World!".
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.
Ändern Sie im XAML-Editor den Wert "Schaltflächeninhalt" von ihrem aktuellen Wert in "Hello World!".
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.
Ä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.
Doppelklicken Sie im Projektmappen-Explorer auf MainWindow.xaml.cs, die CodeBehind-Seite.
Bearbeiten Sie den Ereignishandlercode im daraufhin geöffneten C#-Editorfenster.
Hier finden Sie interessante Dinge. Der Standardereignishandler sieht wie folgt aus:
Lassen Sie uns es ändern, sodass es wie folgt aussieht:
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(); }
Doppelklicken Sie im Projektmappen-Explorer auf MainWindow.xaml.cs, die CodeBehind-Seite.
Bearbeiten Sie den Ereignishandlercode im daraufhin geöffneten C#-Editorfenster.
Hier finden Sie interessante Dinge. Der Standardereignishandler sieht wie folgt aus:
Lassen Sie uns es ändern, sodass es wie folgt aussieht:
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:
Verwenden Sie die Schaltfläche "Start", um die Anwendung auf dem lokalen Rechner zu starten. Es enthält den Text HelloWorld (Package).
Alternativ können Sie " Debuggen>starten" in der Menüleiste auswählen oder F5 drücken, um die App zu starten.
Sehen Sie sich Ihre App an, die gleich nach der Anzeige eines Begrüßungsbildschirms angezeigt wird. Die App sollte ähnlich wie dieses Bild aussehen:
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.
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.
Verwandte Inhalte
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: