WinUI 3-mallar i Visual Studio

Artikel
03/22/2025

När du har konfigurerat utvecklingsdatorn (se Börja utveckla Windows-appar) är du redo att skapa en WinUI 3-app genom att börja från en av WinUI 3-projektmallarna i Visual Studio. I det här avsnittet beskrivs tillgängliga projekt- och objektmallar.

Om du vill komma åt WinUI 3-projektmallarna väljer du i listrutefiltren i dialogrutan New Project respektive C#/C++, Windowsoch WinUI. Du kan också söka efter WinUI-och välja en av de tillgängliga C#- eller C++-mallarna.

WinUI-projektmallar

Projektmallar för WinUI 3

Du kan använda dessa WinUI 3-projektmallar för att börja skapa en app.

Tom applikation, paketerad (WinUI 3 på Skrivbord)

Den här projektmallen skapar en skrivbordsapp för .NET (C#) eller en intern Win32-app (C++) med ett WinUI 3-baserat användargränssnitt. Det genererade projektet innehåller ett grundläggande fönster som härleds från Microsoft.UI.Xaml.Window-klass i WinUI 3-biblioteket som du kan använda för att börja skapa användargränssnittet. Mer information om hur du använder den här projektmallen finns i Skapa ditt första WinUI 3-projekt.

Funktionerna i den här projektmallen varierar mellan versioner av Windows App SDK-tillägget.

Version 1.0 Preview 2: Från och med den här versionen genererar den här projektmallen ett programprojekt med paketmanifestet och annat stöd som behövs för att bygga appen till ett MSIX-paket utan att använda ett separat paketeringsprojekt. Om du vill använda den här projektmallen måste du också installera tillägget MSIX-paketeringsverktyg för ett enda projekt för Visual Studio.

Notera

I version 1.0 Förhandsversion 2 och senare har den här projektmallen endast stöd för en enda körbar fil i det genererade MSIX-paketet. Om du behöver kombinera flera körbara filer i ett enda MSIX-paket måste du använda projektmallen "Tom applikation, paketerad med Windows Application Packaging Project (WinUI 3 för stationärt bruk)" eller lägga till ett Windows Application Packaging Project till din lösning.
Version 1.0 Förhandsversion 1 och tidigare: I dessa versioner genererar den här projektmallen en lösning med en separat Windows Application Packaging Project- som är konfigurerad för att bygga appen till ett MSIX-paket. Du kan också installera MSIX-paketeringsverktygstillägg för ett enskilt projekt för Visual Studio och kombinera paketeringsprojektinställningarna i ditt programprojekt så att du inte längre behöver underhålla ett separat paketeringsprojekt.

Tom app, paketerad med Windows Application Packaging Project (WinUI 3 i Desktop)

Den här projektmallen är tillgänglig i version 1.0 Förhandsversion 1 och senare versioner. Den skapar en skrivbordsapp för .NET (C#) eller en intern Win32-app (C++) med ett WinUI 3-baserat användargränssnitt. Det genererade projektet innehåller ett grundläggande fönster som härleds från Microsoft.UI.Xaml.Window-klass i WinUI 3-biblioteket som du kan använda för att börja skapa användargränssnittet. Mer information om hur du använder den här projektmallen finns i Skapa ditt första WinUI 3-projekt.

Lösningen innehåller också en separat Windows Application Packaging Project- som är konfigurerad för att bygga appen till ett MSIX-paket. Du kan också installera MSIX-paketeringsverktygstillägg för ett enskilt projekt för Visual Studio och kombinera paketeringsprojektinställningarna i ditt programprojekt så att du inte längre behöver underhålla ett separat paketeringsprojekt.

[Experimentell] Blank app (WinUI 3 i UWP)

Den här projektmallen skapar en C#- eller C++ UWP-app som med ett WinUI 3-baserat användargränssnitt. Det genererade projektet innehåller en grundläggande sida som härleds från klassen Microsoft.UI.Xaml.Controls.Page i WinUI 3-biblioteket, som du kan använda för att börja skapa användargränssnittet. Mer information om den här projektmallen finns i Skapa din första WinUI 3-app.

WinUI-projektmallar för andra komponenter

Du kan använda dessa WinUI 3-projektmallar för att skapa komponenter som kan läsas in och användas av en WinUI 3-baserad app.

Mall	Språk	Beskrivning
Klassbibliotek (WinUI 3 i Desktop)	Endast C#	Skapar ett .NET-hanterat klassbibliotek (DLL) i C# som kan användas av andra .NET-skrivbordsappar med ett WinUI 3-baserat användargränssnitt.
[Experimentellt] Klassbibliotek (WinUI 3 i UWP)	Endast C#	Skapar ett hanterat klassbibliotek (DLL) i C# som kan användas av andra UWP-appar med ett WinUI 3-baserat användargränssnitt.
Windows Runtime-komponent (WinUI 3)	C++	Skapar en Windows Runtime-komponent skriven i C++/WinRT som kan användas av valfri UWP- eller skrivbordsapp med ett WinUI 3-baserat användargränssnitt, oavsett vilket programmeringsspråk appen är skriven i.
[Experimentellt] Windows Runtime-komponent (WinUI 3 i UWP)	C#	Skapar en Windows Runtime-komponent skriven i C# som kan användas av alla UWP-appar med ett WinUI 3-baserat användargränssnitt, oavsett vilket programmeringsspråk appen är skriven i.

Objektmallar för WinUI 3

Följande objektmallar är tillgängliga för användning i ett WinUI 3-projekt. Om du vill komma åt dessa WinUI 3-objektmallar högerklickar du på projektnoden i Solution Explorer, väljer Lägg till –>Nytt objektoch klickar på WinUI- i dialogrutan Lägg till nytt objekt.

WinUI-objektmallar

Note

Om du har experimentell kanal eller en äldre förhandsversion av Windows App SDK installerad kan du se en andra uppsättning objektmallar som har prefixet [Experimental]. Vi rekommenderar att du använder dessa [experimentella] objektmallar om du skapar en icke-produktions-/förhandsversionsapp och använder de stabila, icke-markerade objektmallarna om du skapar en skrivbordsapp för produktion.

Mall	Språk	Beskrivning
Tom sida (WinUI 3)	C# och C++	Lägger till en XAML-fil och kodfil som definierar en ny sida som härleds från klassen Microsoft.UI.Xaml.Controls.Page i WinUI 3-biblioteket.
Tomt fönster (WinUI 3 i Desktop)	C# och C++	Lägger till en XAML-fil och kodfil som definierar ett nytt fönster som härleds från Microsoft.UI.Xaml.Window-klass i WinUI 3-biblioteket.
Specialanpassad kontroll (WinUI 3)	C# och C++	Lägger till en kodfil för att skapa en mallbaserad kontroll med ett standardformat. Den mallade kontrollen härleds från klassen Microsoft.UI.Xaml.Controls.Control i WinUI 3-biblioteket. En genomgång som visar hur du använder den här objektmallen finns i Mallade XAML-kontroller för UWP- och WinUI 3-appar med C++/WinRT-- och Mallade XAML-kontroller för UWP- och WinUI 3-appar med C#. Mer information om mallade kontroller finns i Anpassade XAML-kontroller.
Resursordlista (WinUI 3)	C# och C++	Lägger till en tom, nyckelad samling XAML-resurser. Mer information finns i ResourceDictionary- och XAML-resursreferenser.
Resursfil (WinUI 3)	C# och C++	Lägger till en fil för lagring av strängresurser och villkorsstyrda resurser för din app. Du kan använda det här objektet för att lokalisera din app. För mer information, se Lokalisera strängar i din UI och app-paketets manifest.
Användarkontroll (WinUI 3)	C# och C++	Lägger till en XAML-fil och kodfil för att skapa en användarkontroll som härleds från Microsoft.UI.Xaml.Controls.UserControl-klass i WinUI 3-biblioteket. Vanligtvis kapslar en användarkontroll in relaterade befintliga kontroller och tillhandahåller sin egen logik. Mer information om användarkontroller finns i anpassade XAML-kontroller.

Dela via