Quickstart: Een WinUI 3-project maken en uitvoeren

Stel uw hulpprogramma's in, maak een leeg C# WinUI 3-project en bevestig dat het wordt gebouwd en gestart. Kies Visual Studio voor een geïntegreerde editor en foutopsporingsprogramma, of dotnet-nieuw om vanaf de opdrachtregel in elke editor te werken. Gebruik de onderstaande tabbladen om te schakelen tussen de twee benaderingen.

Deze quickstart stopt bij een actief project. Als u een gebruikersinterface, opslag en navigatie wilt toevoegen, gaat u verder met het bouwen van een WinUI 3-notitie-app.

Visual Studio

Uw ontwikkelomgeving instellen

Als u WinUI 3-apps wilt ontwikkelen met Visual Studio, hebt u Visual Studio 2026 nodig met de vereiste workloads en de ontwikkelaarsmodus ingeschakeld.

Instellen met WinGet (aanbevolen)

Open Windows Terminal en voer de volgende opdracht uit in PowerShell om automatisch Visual Studio 2026 te installeren met de vereiste workloads en de ontwikkelaarsmodus in te schakelen met behulp van een WinGet-configuratiebestand:

winget configure -f https://aka.ms/winui-config

Zie de README op GitHub voor meer informatie over het configuratiebestand.

Note

Als WinGet niet beschikbaar is in uw omgeving, installeert u deze eerst:

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

Zie WinGet gebruiken voor meer informatie.

Handmatig instellen

Als u liever hulpprogramma's handmatig installeert:

1. Ontwikkelaarsmodus inschakelen: open Windows Instellingen, ga naar System > Advanced en schakel de ontwikkelaarsmodus in op Aan.

2. Download en installeer Visual Studio 2026. Zie Install Visual Studio voor meer informatie.

3. Selecteer in het Visual Studio Installer de winUI-toepassingsontwikkelingsworkload op het tabblad Workloads. Voor C++-ontwikkeling selecteert u ook C++ WinUI-hulpprogramma's voor app-ontwikkeling onder die workload in het deelvenster Installatiedetails.

   

Aanbeveling

Als u WinUI-sjablonen niet ziet nadat u Visual Studio hebt geïnstalleerd, opent u het Visual Studio Installer, selecteert u Modify en controleert u of de workload WinUI-toepassingsontwikkeling is ingeschakeld. Start Visual Studio opnieuw nadat u de installatie hebt gewijzigd.

Uw eerste WinUI 3-app maken en starten

1. Open Visual Studio 2026 en selecteer Een nieuw project maken.

2. Zoek naar WinUI, selecteer de WinUI Blank App (Packaged) C#-projectsjabloon en selecteer Volgende.

   

3. Voer een projectnaam in en selecteer Maken.

   

4. Druk op Start (F5) om uw app te bouwen en uit te voeren.

   

   Uw app bouwt, implementeert en start in de foutopsporingsmodus:

   

   U hebt uw eerste WinUI 3-app gebouwd en gestart. 🎉

Opdrachtregel

Vereiste voorwaarden

• Windows 10 versie 1809 (build 17763) of hoger
• Ontwikkelaarsmodus ingeschakeld (ms-settings:developers)
• .NET 10 SDK of hoger (controleer metdotnet --version)

Uw eerste WinUI 3-app maken en uitvoeren

1. Installeer de WinUI 3-projectsjablonen voor dotnet new (eenmaal uitvoeren):

   dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
   

2. Maak een nieuw project en navigeer ernaartoe:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Bouw het project:

   dotnet build
   

4. De app uitvoeren:

   dotnet run
   

   De sjabloon bevatMicrosoft.Windows.SDK.BuildTools.WinApp, die wordt gekoppeld aan het .NET CLI-doel run om een foutopsporingsidentiteit te registreren en de app te starten met msiX-pakketidentiteit. Er is geen handmatige implementatiestap vereist.

   Er wordt een leeg app-venster geopend. U hebt uw eerste WinUI 3-app gebouwd en gestart. 🎉

Probleemoplossingsproces

Als u problemen ondervindt bij het bouwen of uitvoeren van uw eerste app, kunt u deze veelvoorkomende oplossingen proberen:

Probleem	Solution
WinUI-sjablonen worden niet weergegeven in Visual Studio	Open het Visual Studio-installatieprogramma, selecteer Wijzigen en controleer of de workload voor het ontwikkelen van WinUI-toepassingen is gecontroleerd. Start Visual Studio opnieuw nadat u de installatie hebt gewijzigd. Zie de tip in Uw ontwikkelomgeving instellen voor meer informatie.
Build mislukt met SDK-versiefouten	Open het Visual Studio Installer en selecteer Afzonderlijke onderdelen. Controleer of de Windows SDK-versie van uw projectdoelen is geïnstalleerd. Controleer in het projectbestand of deze TargetFramework overeenkomt met de geïnstalleerde SDK (bijvoorbeeld net10.0-windows10.0.26100.0).
NuGet-herstelfouten	Wis de lokale NuGet-cache en herstel opnieuw. Voer in een terminal de volgende opdracht uit: dotnet nuget locals all --clear vervolgens dotnet restore.
Fout 'Ontwikkelaarsmodus niet ingeschakeld'	Open Windows Settings >System > Advanced en schakel de ontwikkelaarsmodus in op Aan. Zie De ontwikkelaarsmodus inschakelen voor meer informatie.
Wijzigingen die niet worden herkend na de eerste SDK-installatie	Nadat u de Windows App SDK of Visual Studio workloads voor het eerst hebt geïnstalleerd of bijgewerkt, start u Visual Studio opnieuw op, zodat de nieuwe onderdelen worden opgehaald.

Aanbeveling

Als geen van de bovenstaande problemen uw probleem oplost, zoekt u de Windows App SDK GitHub problemen of vraagt u dit op Microsoft Q& A.

Volgende stappen

Uw ontwikkelinstallatie is gereed. De aanbevolen volgende stap is de zelfstudie over Notities, waarin je de basisbeginselen van XAML en C# in Visual Studio leert. Als u liever meer wilt leren over een workflow met AI-ondersteuning, kies dan in plaats daarvan de zelfstudie Task Tally; u hoeft niet beide te voltooien.

Een WinUI 3-notitie-app bouwen

Zie Een WinUI 3-taak-app bouwen met een AI-assistent voor het optionele pad met AI. Er wordt uitgelegd hoe u gegenereerde code beperkt tot WinUI 3 en het resultaat controleert.

Een WinUI 3-notitie-app bouwen
Meer informatie over XAML, gebeurtenissen, bestandsopslag, gegevensbinding en navigatie in een C#-app met twee pagina's.

WinUI 3 Gallery
Bekijk interactieve voorbeelden van WinUI-besturingselementen, -functies en -functionaliteit.

Voorbeelden en hulpmiddelen
Blader door codevoorbeelden, startersprojecten en hulpprogramma's om uw ontwikkeling te versnellen.