Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym samouczku pokazano, jak używać języka XAML i języka C# z Native AOT (przed czasem) w celu utworzenia prostej aplikacji "Hello, World!" dla Universal Windows Platform (UWP) w Windows. Za pomocą pojedynczego projektu w Microsoft Visual Studio można utworzyć aplikację działającą we wszystkich obsługiwanych wersjach Windows 10 i Windows 11.
Tutaj dowiesz się, jak wykonywać następujące czynności:
- Utwórz nowy projekt UWP w Visual Studio.
- Napisz kod XAML, aby zmienić interfejs użytkownika na stronie początkowej.
- Uruchom projekt na komputerze lokalnym w Visual Studio.
- Użyj narzędzia SpeechSynthesizer , aby podczas naciskania przycisku komunikować się z aplikacją.
Wymagania wstępne
- Co to jest aplikacja uniwersalna Windows?
- Pobierz Visual Studio (i Windows). Jeśli potrzebujesz pomocy, dowiedz się, jak skonfigurować.
- Zakładamy również, że używasz domyślnego układu okna w Visual Studio. Jeśli zmienisz układ domyślny, możesz zresetować go w menu okna
za pomocą polecenia Resetuj układ okna .
Uwaga / Notatka
W tym samouczku używany jest Visual Studio 2026. Jeśli używasz innej wersji Visual Studio, może to wyglądać nieco inaczej.
Krok 1. Tworzenie nowego projektu w Visual Studio
Uruchom Visual Studio.
W menu File wybierz Nowy > Project aby otworzyć okno dialogowe Nowy Project.
Filtruj listę dostępnych szablonów, wybierając C# z listy rozwijanej Languages oraz UWP z listy rozwijanej Project types, aby zobaczyć listę dostępnych szablonów projektów UWP dla deweloperów C#.
(Jeśli nie widzisz żadnych szablonów UWP, może brakować składników do tworzenia aplikacji UWP. Możesz powtórzyć proces instalacji i dodać obsługę UWP, otwierając Instalatora Visual Studio z menu Start Windows. Aby uzyskać więcej informacji, zobacz Konfigurowanie Visual Studio na potrzeby programowania na platformie UWP.)
Wybierz szablon Pusta aplikacja UWP.
Ważne
Szablon pustej aplikacji UWP jest domyślny i jest przeznaczony dla najnowszej .NET z natywną funkcją AOT. Jeśli widzisz szablon UWP Blank App (.NET Native), jest to starszy szablon przeznaczony dla starszego środowiska uruchomieniowego .NET Native. Aplikacje korzystające z nowoczesnego szablonu .NET mają dostęp do najnowszych funkcji .NET i języka C#, lepszej wydajności i lepszych narzędzi. Aby uzyskać więcej informacji na temat różnic, zobacz Modernizenie aplikacji platformy UWP przy użyciu .NET i natywnego AOT.
Wybierz Dalej i wprowadź ciąg "HelloWorld" jako nazwę projektu. Wybierz Utwórz.
Uwaga / Notatka
Jeśli po raz pierwszy użyto Visual Studio, może zostać wyświetlone okno dialogowe Ustawienia z prośbą o włączenie trybu Developer. Tryb dewelopera to specjalne ustawienie, które umożliwia korzystanie z określonych funkcji, takich jak uprawnienia do bezpośredniego uruchamiania aplikacji, a nie tylko ze Sklepu. Aby uzyskać więcej informacji, przeczytaj Włączanie urządzenia na potrzeby programowania. Aby kontynuować pracę z tym przewodnikiem, wybierz tryb dewelopera, kliknij przycisk Taki zamknij okno dialogowe.
zrzut ekranu

Zostanie wyświetlone okno dialogowe Wersja docelowa/Minimalna wersja. Ustawienia domyślne są odpowiednie dla tego samouczka, dlatego wybierz pozycję OK, aby utworzyć projekt.
zrzut ekranu

Po otwarciu nowego projektu jego pliki są wyświetlane w okienku Eksplorator rozwiązań po prawej stronie. Może być konieczne wybranie karty Eksplorator rozwiązań zamiast karty Properties lub GitHub Copilot Chat, aby wyświetlić pliki.
Mimo że UWP Blank App jest minimalnym szablonem, nadal zawiera wiele plików. Te pliki są niezbędne dla wszystkich aplikacji platformy UWP korzystających z języka C#. Każdy projekt platformy UWP tworzony w Visual Studio zawiera je.
Co znajduje się w plikach?
Aby wyświetlić i edytować plik w projekcie, kliknij dwukrotnie plik w Eksplorator rozwiązań. Rozwiń plik XAML tak samo jak folder, aby wyświetlić skojarzony z nim plik kodu. Pliki XAML otwarte w widoku podzielonym, który pokazuje zarówno powierzchnię projektową, jak i edytor XAML.
Uwaga / Notatka
Co to jest XAML? Extensible Application Markup Language (XAML) to język używany do definiowania interfejsu użytkownika aplikacji. Można go wprowadzić ręcznie lub utworzyć przy użyciu narzędzi do projektowania Visual Studio. Plik .xaml ma powiązany plik .xaml.cs, który zawiera logikę. Razem kod XAML i kod-behind tworzą kompletną klasę. Aby uzyskać więcej informacji, zobacz XAML overview.
App.xaml i App.xaml.cs
- App.xaml to plik, w którym deklarujesz zasoby używane w aplikacji.
- App.xaml.cs jest plikiem za pomocą kodu dla pliku App.xaml. Podobnie jak wszystkie strony kodu, zawiera konstruktor, który wywołuje metodę
InitializeComponent. Nie piszesz metodyInitializeComponent. Jest on generowany przez Visual Studio, a jego głównym celem jest zainicjowanie elementów zadeklarowanych w pliku XAML. - App.xaml.cs to punkt wejścia aplikacji.
- App.xaml.cs zawiera także metody obsługi aktywacji oraz zawieszenia aplikacji.
MainPage.xaml
- Plik MainPage.xaml służy do definiowania interfejsu użytkownika aplikacji. Elementy można dodawać bezpośrednio przy użyciu znaczników XAML lub użyć narzędzi projektowych udostępnianych przez Visual Studio.
- MainPage.xaml.cs jest plikiem zaplecza kodowego dla pliku MainPage.xaml. Jest to miejsce, w którym dodajesz logikę aplikacji i procedury obsługi zdarzeń.
- Te dwa pliki definiują nową klasę o nazwie
MainPage, która dziedziczy z Page w przestrzeni nazwHelloWorld.
Package.appxmanifest
- Plik manifestu opisujący aplikację: jego nazwę, opis, kafelek, stronę początkową itp.
- Zawiera listę zależności, zasobów i plików, które zawiera aplikacja.
zestaw obrazów logo
- Zasoby/Square150x150Logo.scale-200.png i Wide310x150Logo.scale-200.png reprezentują aplikację (średni lub szeroki rozmiar) w menu Start.
- Zasoby/Square44x44Logo.png reprezentuje aplikację na liście aplikacji menu Start, paska zadań i menedżera zadań.
- Zasoby/StoreLogo.png reprezentuje aplikację w Microsoft Store.
- Assets/SplashScreen.scale-200.png to ekran powitalny wyświetlany podczas uruchamiania aplikacji.
- Zasoby/LockScreenLogo.scale-200.png mogą służyć do reprezentowania aplikacji na ekranie blokady, gdy system jest zablokowany.
Krok 2. Dodawanie przycisku
Korzystanie z widoku projektanta
Dodajmy przycisk do naszej strony. W tym samouczku będziesz pracować z kilkoma wymienionymi wcześniej plikami: App.xaml, MainPage.xaml i MainPage.xaml.cs.
Kliknij dwukrotnie plik MainPage.xaml , aby otworzyć go w edytorze XAML.
Uwaga / Notatka
Podczas pracy z szablonem UWP Blank App, który używa nowoczesnej platformy .NET, widok projektu nie będzie widoczny. Jeśli chcesz pracować z projektem platformy UWP z widokiem projektu XAML, możesz użyć szablonu UWP Pusta aplikacja (.NET Natywna) zamiast tego. Jak wspomniano wcześniej, szablon UWP Pusta aplikacja (.NET Natywna) jest nieco inny niż szablon UWP Pusta aplikacja ale ma tę samą podstawową strukturę. Główną różnicą jest to, że szablon UWP Pusta aplikacja (.NET Native) używa .NET Native do skompilowania aplikacji. Aby uzyskać informacje na temat zalet korzystania z nowoczesnego szablonu .NET, zobacz sekcję Modernizuj aplikację platformy UWP za pomocą .NET i Natywnego AOT.
Dodaj następujący kod XAML do elementu
<Grid>w pliku MainPage.xaml. Możesz wpisać go lub skopiować i wkleić z tego miejsca:<Button x:Name="button" Content="Button" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top"/>W tym momencie utworzono bardzo prostą aplikację. Jest to dobry moment, aby skompilować, wdrożyć i uruchomić aplikację i zobaczyć, jak wygląda. Aplikację można debugować na komputerze lokalnym, w symulatorze lub emulatorze albo na urządzeniu zdalnym. Oto menu urządzenia docelowego w Visual Studio:
Domyślnie aplikacja jest uruchamiana na komputerze lokalnym. Menu urządzenia docelowego zawiera kilka opcji debugowania aplikacji na urządzeniach z rodziny urządzeń stacjonarnych.
- HelloWorld (uruchamia go na komputerze lokalnym)
- WSL
- Pobierz nowe emulatory...
Uruchom aplikację, aby zobaczyć przycisk w akcji. Aby rozpocząć debugowanie na komputerze lokalnym, możesz uruchomić aplikację, wybierając pozycję Debuguj | Uruchom element Debugowanie w menu, klikając przycisk Rozpocznij debugowanie na pasku narzędzi (z etykietą HelloWorld ) lub naciskając F5.
Aplikacja zostanie otwarta w oknie i zostanie wyświetlony domyślny ekran powitalny. Ekran powitalny jest definiowany przez obraz (SplashScreen.png) i kolor tła (określony w pliku manifestu aplikacji).
Ekran powitalny zniknie, a następnie zostanie wyświetlona aplikacja. Wygląda na to:
Naciśnij klawisz Windows, aby otworzyć menu Start, a następnie wybierz pozycję All aby wyświetlić wszystkie aplikacje. Zwróć uwagę, że wdrożenie aplikacji lokalnie dodaje ją do listy programów w menu Start . Aby ponownie uruchomić aplikację później (nie w trybie debugowania), możesz ją wybrać w menu Start .
Nie robi to zbyt wiele — ale gratulacje, utworzono i wdrożono pierwszą aplikację platformy UWP na komputerze lokalnym.
Aby zatrzymać debugowanie:
Kliknij przycisk Zatrzymaj debugowanie (
) na pasku narzędzi.–lub–
W menu Debugowanie kliknij pozycję Zatrzymaj debugowanie.
–lub–
Zamknij okno aplikacji.
Zmień tekst przycisku, zmieniając
Contentwartość zButtonnaHello, world!.<Button x:Name="button" Content="Hello, world!" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top"/>Jeśli ponownie uruchomisz aplikację, przycisk zostanie zaktualizowany, aby wyświetlić nowy tekst.
Krok 3. Programy obsługi zdarzeń
"Procedura obsługi zdarzeń" wydaje się skomplikowana, ale jest to po prostu inna nazwa kodu wywoływanego w przypadku wystąpienia zdarzenia (na przykład kliknięcie przycisku przez użytkownika).
Zatrzymaj uruchamianie aplikacji, jeśli jeszcze tego nie zrobiono.
Zacznij wpisywać
Clickw edytorze XAML, a Visual Studio wyświetli listę możliwych zdarzeń. Wybierz Kliknij z listy.
Następnie wybierz
<New Event Handler>z listy. Spowoduje to utworzenie nowej metody obsługi zdarzeń w pliku code-behind (MainPage.xaml.cs) i dodanie zdarzeniaClickdo elementu przycisku w kodzie XAML.
Edytor XAML automatycznie dodaje
Clickzdarzenie do elementu przycisku w kodzie XAML:<Button x:Name="button" Content="Hello, world!" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top" Click="button_Click"/>Dodaje to również program obsługi zdarzeń do pliku zaplecza (MainPage.xaml.cs). Procedura obsługi zdarzeń to metoda, która zostanie wywołana po kliknięciu przycisku. Nazwa metody to
button_Click, a ma dwa parametry:object senderiRoutedEventArgs e.private void button_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e) { }Zdarzenie
Clickto standardowe zdarzenie dla przycisków. Gdy użytkownik kliknie przycisk, metodabutton_Clickjest wywoływana.Edytuj kod programu obsługi zdarzeń w MainPage.xaml.cs, pliku zaplecza. To jest miejsce, w którym rzeczy są interesujące. Zmieńmy ją, tak aby wyglądała następująco:
private async void button_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e) { var 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(); }Upewnij się, że podpis metody teraz zawiera słowo kluczowe async, w przeciwnym razie wystąpi błąd podczas próby uruchomienia aplikacji.
Co właśnie zrobiliśmy?
Ten kod używa niektórych interfejsów API Windows do utworzenia obiektu syntezy mowy, a następnie podaje tekst do powiedzenia. (Aby uzyskać więcej informacji na temat używania SpeechSynthesis, zobacz sekcję SpeechSynthesis namespace w dokumentacji interfejsu API środowisko wykonawcze systemu Windows (WinRT).)
Po uruchomieniu aplikacji i kliknięciu przycisku komputer (lub telefon) dosłownie powie "Hello, World!".
Podsumowanie
Gratulacje, udało Ci się utworzyć pierwszą aplikację platformy UWP dla Windows z nowoczesnym .NET!
Aby dowiedzieć się, jak używać języka XAML do układania kontrolek używanych przez aplikację, wypróbuj samouczek siatkilub przejdź prosto do kolejnych kroków .