Dela via


Självstudie: Skapa ditt första Universal Windows Platform-program i Visual Studio med XAML och C#

I den här självstudien, som en introduktion till Visual Studio Integrated Development Environment (IDE), skapar du en "Hello World"-app som körs på valfri Windows 10-enhet eller senare enhet. För att göra det använder du en UWP-projektmall (Universal Windows Platform), XAML (Extensible Application Markup Language) och programmeringsspråket C#.

Not

Om du är nöjd med dina aktuella funktioner i UWP (Universal Windows Platform) behöver du inte migrera projekttypen till Windows App SDK. WinUI 2.x och Windows SDK stöder UWP-projekttyper. Om du vill komma igång med WinUI 3 och Windows App SDK kan du följa stegen i självstudien om Windows App SDK.

I den här handledningen:

  • Skapa ett projekt
  • Skapa ett program
  • Kör programmet

Förutsättningar

Du behöver:

  • Visual Studio. Besök Visual Studio-nedladdningssidan för en kostnadsfri version.

  • Arbetsbelastningar och komponenter som krävs för att utveckla en UWP-app. Om du vill verifiera eller installera en arbetsbelastning i Visual Studio väljer du Verktyg>Hämta verktyg och funktioner, eller i fönstret Skapa ett nytt projekt väljer du länken Installera fler verktyg och funktioner . Mer information finns i Ändra arbetsbelastningar eller enskilda komponenter.

    På fliken Arbetsbelastningar i Visual Studio Installer väljer du följande arbetsbelastningar och komponenter:

    • För apputveckling med UWP väljer du arbetsbelastningen WinUI-programutveckling . Välj sedan det UWP-alternativ du behöver i fönstret Installationsinformation under noden WinUI-programutveckling (detta kommer också att välja eventuella ytterligare nödvändiga komponenter)

    • För C#väljer du Universella Windows-plattformsverktyg och Windows 11 SDK (10.0.26100.0).

    • Den här självstudien kräver projektmallen UWP Blank App.

    Not

    I Visual Studio 17.10 – 17.12 kallas den här arbetsbelastningen för Windows-programutveckling.

Du behöver Visual Studio för att slutföra den här självstudien. Besök Visual Studio-nedladdningssidan för en kostnadsfri version.

Not

Den här självstudien kräver projektmallen Tom app (Universal Windows). Under installationen väljer du arbetsbelastningen Universell Windows-plattformsutveckling :

Skärmbild av Installationsprogrammet för Visual Studio som visar arbetsbelastningen för utveckling av Universal Windows Platform.

Om du redan har Visual Studio installerat och behöver lägga till det väljer du Verktyg>Hämta verktyg och funktioner på menyn, eller i fönstret Skapa ett nytt projekt väljer du länken Installera fler verktyg och funktioner .

Skärmbild av fönstret Skapa ett nytt projekt som visar länken Installera fler verktyg och funktioner.

Skapa ett projekt

Skapa först ett Universal Windows Platform-projekt. Projekttypen levereras med alla mallfiler du behöver, innan du ens lägger till något!

  1. Öppna Visual Studio och välj Skapa ett nytt projekt i startfönstret.

  2. På skärmen Skapa ett nytt projekt anger du Universal Windows i sökrutan, väljer C#-mallen för Tom app (Universell Windows) och väljer sedan Nästa.

    Skärmbild av dialogrutan

  3. Ge projektet ett namn, HelloWorld, och välj Skapa.

    Skärmbild av dialogrutan

  4. Acceptera standardinställningarna för Målversion och Lägsta version i dialogrutan Nytt universellt Windows-plattformsprojekt .

    Skärmbild av dialogrutan Nytt universellt Windows-plattformsprojekt som visar standardinställningarna För målversion och Lägsta version.

    Not

    Om det är första gången du använder Visual Studio för att skapa en UWP-app kan dialogrutan Inställningar visas. Välj Utvecklarläge och välj sedan Ja.

    Skärmbild som visar dialogrutan UWP-inställningar med alternativet för att aktivera utvecklarläge.

    Visual Studio installerar ytterligare ett developer mode-paket åt dig. När paketinstallationen är klar stänger du dialogrutan Inställningar .

  1. Öppna Visual Studio och välj Skapa ett nytt projekt i startfönstret.

  2. På skärmen Skapa ett nytt projekt anger du Universal Windows i sökrutan, väljer C#-mallen för Tom app (Universell Windows) eller UWP Tom app i Visual Studio 2022 17.10 eller senare och väljer sedan Nästa.

    Skärmbild av dialogrutan "Skapa ett nytt projekt" med "Universal Windows" angivet i sökrutan och projektmallen "Tom app (Windows universell)" markerad.

  3. Ge projektet ett namn, HelloWorld, och välj Skapa.

    Skärmbild av dialogrutan

  4. Acceptera standardinställningarna för Målversion och Lägsta version i dialogrutan Nytt universellt Windows-plattformsprojekt .

    Skärmbild av dialogrutan Nytt universellt Windows-plattformsprojekt som visar standardinställningarna För målversion och Lägsta version.

    Not

    Om det är första gången du använder Visual Studio för att skapa en UWP-app visas dialogrutan Aktivera utvecklarläge för Windows . Välj inställningar för utvecklare för att öppna Inställningar. Aktivera utvecklarläge och välj sedan Ja.

    Skärmbild som visar dialogrutan UWP-inställningar med alternativet för att aktivera utvecklarläge.

    Visual Studio installerar ytterligare ett developer mode-paket åt dig. När paketinstallationen är klar stänger du dialogrutan Inställningar .

Skapa programmet

Det är dags att börja utveckla. Lägg till en knappkontroll, lägg till en åtgärd på knappen och starta sedan appen "Hello World" för att se hur den ser ut.

Lägg till en knapp på Design-duken

  1. Dubbelklicka i MainPage.xaml för att öppna en delad vy.

    Skärmbild av Solution Explorer-fönstret som visar egenskaper, referenser, tillgångar och filer i HelloWorld-projektet med filen MainPage.xaml markerad.

    Det finns två fönsterrutor: XAML Designer, som innehåller en designarbetsyta, och XAML-redigeraren, där du kan lägga till eller ändra kod.

    Skärmbild som visar MainPage.xaml öppen i Visual Studio IDE och XAML Designer-fönstret visar en tom designyta och fönstret XAML-redigerare visar en del av XAML-koden.

  2. Välj Verktygslåda för att öppna verktygslådans utfällningsfönster.

    Skärmbild som visar fliken för det utfällbara fönstret

    Om du inte ser alternativet Verktygslåda kan du öppna det från menyraden. Om du vill göra det väljer du Visa>verktygsfält. Eller tryck på Ctrl+Alt+X.

  3. Välj ikonen Fäst för att fästa fönstret Verktygslåda.

    Skärmbild som visar knappnålsikonen markerad i den övre listen i fönstret Verktygslåda.

  4. Välj knappkontrollen och dra den sedan till designarbetsytan.

    Skärmbild som visar knappen markerad i fönstret Verktygslåda och en knappkontroll på designarbetsytan.

    Om du tittar på koden i XAML-redigeraren ser du att knappen också visas där:

    Skärmbild som visar koden för den nyligen tillagda knappen markerad i XAML-redigeraren.

  1. Dubbelklicka i MainPage.xaml för att öppna en delad vy.

    Skärmbild av Solution Explorer-fönstret som visar egenskaper, referenser, tillgångar och filer i HelloWorld-projektet. Filen MainPage.xaml är markerad.

    Det finns två fönsterrutor: XAML Designer, som innehåller en designarbetsyta, och XAML-redigeraren, där du kan lägga till eller ändra kod.

    Skärmbild som visar MainPage.xaml öppen i Visual Studio IDE. Fönstret XAML Designer visar en tom designyta och fönstret XAML-redigerare visar en del av XAML-koden.

  2. Välj Verktygslåda för att öppna verktygslådans utfällningsfönster.

    Skärmbild som visar fliken för det utfällbara fönstret

    Om du inte ser alternativet Verktygslåda kan du öppna det från menyraden. Om du vill göra det väljer du Visa>verktygsfält. Eller tryck på Ctrl+Alt+X.

  3. Välj ikonen Fäst för att fästa fönstret Verktygslåda.

    Skärmbild som visar knappnålsikonen markerad i den övre listen i fönstret Verktygslåda.

  4. Välj knappkontrollen och dra den sedan till designarbetsytan.

    Skärmbild som visar knappen markerad i fönstret Verktygslåda och en knappkontroll på designarbetsytan.

    Om du tittar på koden i XAML-redigeraren ser du att knappen också visas där:

    Skärmbild som visar koden för den nyligen tillagda knappen markerad i XAML-redigeraren.

Lägg till en etikett på knappen

  1. I XAML-redigeraren ändrar du Button Content värdet från Knapp till Hello World!

    Skärmbild som visar XAML-koden för knappen i XAML-redigeraren, där egenskapen Innehåll har ändrats till Hello World!

  2. Observera att knappen i XAML Designer också ändras.

    Skärmbild som visar knappkontrollen på arbetsytan i XAML Designer med etiketten för knappen ändrad till Hello World!

  1. I XAML-redigeraren ändrar du Button Content värdet från Knapp till Hello World!

    Skärmbild som visar XAML-koden för knappen i XAML-redigeraren med värdet för egenskapen Innehåll ändrat till

  2. Observera att knappen i XAML Designer också ändras.

    Skärmbild som visar knappkontrollen på arbetsytan i XAML Designer med etiketten för knappen ändrad till Hello World!

Lägga till en händelsehanterare

En händelsehanterare låter komplicerad, men det är bara ett annat namn för kod som anropas när en händelse inträffar. I det här fallet lägger den till en åtgärd till hello world! -knappen.

  1. Dubbelklicka på knappkontrollen på designarbetsytan.

  2. Redigera händelsehanterarkoden i MainPage.xaml.cs, sidan bakom koden.

    Det är här saker blir intressanta. Standardhändelsehanteraren ser ut så här:

    Skärmbild som visar C#-koden för standardhändelsehanteraren för Button_Click.

    Ändra den så att den ser ut så här:

    Skärmbild som visar C#-koden för den nya asynkrona Button_Click händelsehanteraren.

    Här är koden för att kopiera och klistra in:

    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. Dubbelklicka på knappkontrollen på designarbetsytan.

  2. Redigera händelsehanterarkoden i MainPage.xaml.cs, sidan bakom koden.

    Det är här saker blir intressanta. Standardhändelsehanteraren ser ut så här:

    Skärmbild som visar C#-koden för standardhändelsehanteraren för Button_Click.

    Ändra den så att den ser ut så här:

    Skärmbild som visar C#-koden för den nya asynkrona Button_Click händelsehanteraren.

    Här är koden för att kopiera och klistra in:

    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();
    }
    

Vad gjorde vi just?

Koden använder vissa Windows-API:er för att skapa ett talsyntesobjekt och ger det sedan lite text att säga. Mer information om hur du använder SpeechSynthesisfinns i System.Speech.Synthesis.

Kör programmet

Det är dags att skapa, distribuera och starta UWP-appen "Hello World" för att se hur den ser ut och låter. Så här gör du.

  1. Använd knappen Spela upp för att starta programmet på den lokala datorn. Den har texten Lokal dator.

    Skärmbild som visar den nedrullningsbara rutan öppen bredvid knappen Spela upp med

    Du kan också välja Felsöka>Starta felsökning från menyraden eller trycka på F5 för att starta appen.

  2. Visa din app, som visas strax efter att en välkomstskärm försvinner. Appen bör se ut liknande denna figur:

    Skärmbild som visar UWP-programmet Hello World som körs.

  3. Välj knappen Hello World .

    Din Windows 10- eller senare-enhet säger bokstavligen "Hello, World!"

  4. Stäng appen genom att välja knappen Stoppa felsökning i verktygsfältet. Du kan också välja Felsöka>Sluta felsöka från menyraden eller trycka på Skift+F5.

Det är dags att skapa, distribuera och starta UWP-appen "Hello World" för att se hur den ser ut och låter. Så här gör du.

  1. Använd knappen Spela upp (den har texten Lokal dator) för att starta programmet på den lokala datorn.

    Skärmbild som visar den nedrullningsbara rutan öppen bredvid knappen Spela upp med

    Du kan också välja Felsöka>Starta felsökning från menyraden eller trycka på F5 för att starta appen.

  2. Visa din app, som visas strax efter att en välkomstskärm försvinner. Appen bör se ut ungefär så här:

    Skärmbild som visar UWP-programmet Hello World som körs.

  3. Välj knappen Hello World .

    Din Windows 10- eller senare-enhet säger bokstavligen "Hello, World!"

  4. Stäng appen genom att välja knappen Stoppa felsökning i verktygsfältet. Du kan också välja Felsöka>Sluta felsöka från menyraden eller trycka på Skift+F5.

Nästa steg

Grattis för att du har slutfört den här genomgången! Vi hoppas att du har lärt dig några grunderna om UWP och Visual Studio IDE. Om du vill veta mer fortsätter du med följande självstudie: