Windows uygulama geliştirme için Visual Studio

Visual StudioWinUI ve Windows Uygulama SDK'sı ile Windows uygulamaları oluşturmak için önerilen IDE'dir. XAML tabanlı uygulama geliştirme amacıyla oluşturulmuş Windows platformu ve araçlarıyla derin tümleştirme sağlar.

Windows uygulama geliştiricileri için temel özellikler şunlardır:

  • XAML Çalışırken Yeniden Yükleme — uygulamanız çalışırken XAML işaretlemesini değiştirin ve yeniden başlatmadan değişikliklerin anında uygulandığını görün
  • XAML Canlı Görsel Ağaç — Düzen sorunlarını ayıklamak ve öğe hiyerarşisini anlamak için çalışan uygulamanızın çalışma zamanı görsel ağacını inceleyin
  • XAML ve C#/C++ için IntelliSense — hem işaretleme hem de arka plandaki kod için kod tamamlama, hızlı bilgiler ve hata vurgulama sağlayın
  • Tümleşik hata ayıklama — XAML ve kodda kesme noktaları ayarlama, veri bağlamalarını inceleme ve kullanıcı arabirimi işleme sorunlarını tanılama

Başlamak için bkz. WinUI 3 projesi oluşturma ve çalıştırma.

WinUI project şablonları

Visual Studio hızlı bir şekilde WinUI uygulamaları oluşturmanıza yardımcı olacak proje şablonları içerir. Bunları bulmak için File>New>Project açın, project türü açılan menüsünde WinUI filtreleyin veya WinUI için arama yapın.

WinUI proje şablonları

Uygulama şablonları

Başlamak istediğiniz uygulama kabuğunu temel alan bir şablon seçin. Oluşturduğu uygulamanın ekran görüntüsünü görmek için bir şablon adı seçin.

Şablon Language winapp CLI şablonu Açıklama
WinUI Boş Uygulaması (Paketlenmiş) C# ve C++ winui (C#) İçeriği olmayan tek bir pencere. Bu, çoğu yeni uygulama için önerilen başlangıç noktasıdır.
WinUI Gezinti Uygulaması C# winui-navview Giriş, Hakkında ve Ayarlar sayfalarını içeren bir NavigationView kabuğu.
WinUI TabView Uygulaması C# winui-tabview Sekmeleri başlık çubuğunda olan bir TabView kabuğu.
WinUI MVVM Uygulaması C# winui-mvvm CommunityToolkit.Mvvm ile Model-View-ViewModel (MVVM) desenini kullanan bir sayfa ve görünüm modeli.
Boş Uygulama (WAP Project ile paketlenmiş) C# ve C++ Mevcut değil Boş bir uygulama ve ayrı bir Windows Uygulama Paketleme Project.

Komut satırından proje oluşturma

C# uygulama şablonları, Windows Uygulaması Geliştirme CLI'si (winapp CLI) aracılığıyla terminalden de kullanılabilir. Şablon adını tablodan winapp new öğesine geçirin, ardından uygulamayı winapp run ile derleyip başlatın:

winapp new --name MyApp --template winui-navview --use-defaults
cd MyApp
winapp run

Yüklenen tüm şablonları görmek için komutunu çalıştırın winapp new --list . Oluşturulan proje standart bir .csproj olduğundan, projeyi istediğiniz zaman Visual Studio'da açabilirsiniz. Daha fazla bilgi için bkz. WinUI ile winapp CLI kullanma.

WinUI Boş Uygulaması (Paketlenmiş)

WinUI tabanlı kullanıcı arabirimiyle C# (.NET) veya C++ (Win32) içinde bir masaüstü uygulaması oluşturur. project, Microsoft.UI.Xaml.Window'dan türetilen ve kendi denetimlerinizi ve sayfalarınızı eklemeniz için hazır olan tek bir pencereyle başlar. Bu, çoğu yeni uygulama için önerilen başlangıç noktasıdır. İzlenecek yol için bkz. WinUI 3 projesi oluşturma ve çalıştırma.

WinUI Boş Uygulama şablonundan oluşturulan ve başlık çubuğu içeren boş bir pencere gösteren bir uygulama.

WinUI Gezinme Uygulaması

Sol bölmede NavigationView bulunan bir C# uygulaması oluşturur. Şablon Home ve Hakkında sayfalarını, bir Ayarlar öğesini ve bunlar arasında geçiş yapılan gezinti kodunu içerir.

Giriş, Hakkında ve Ayarlar öğelerini ve Giriş sayfasını içeren bir gezinti bölmesini gösteren WinUI Gezinti Uygulaması şablonundan oluşturulan bir uygulama.

WinUI TabView Uygulaması

Başlık çubuğuna uzanan TabView ile bir C# uygulaması oluşturur. Şablonda Giriş ve Hakkında sekmeleri ile yeni sekmeler eklemeye yönelik bir düğme bulunur.

WinUI TabView Uygulaması şablonundan oluşturulan ve başlık çubuğunda Giriş ve Hakkında sekmelerini gösteren bir uygulama.

WinUI MVVM Uygulaması

Kullanıcı arabirimini MVVM düzeniyle mantıktan ayıran bir C# uygulaması oluşturur. Şablon, gözlemlenebilir özellikler ve komutlar için CommunityToolkit.Mvvm kullanır ve görünüm modeline bağlı bir sayaç gösterir.

WinUI MVVM Uygulama şablonundan oluşturulan, Hello, WinUI! başlığını ve artırma ve azaltma düğmeleri içeren bir sayacı gösteren bir uygulama.

Boş Uygulama (WAP Project ile paketlenmiş)

Yukarıdaki WinUI Boş Uygulama (Paketlenmiş) şablonuyla aynı, ancak çözüme ayrı bir Windows Uygulaması Paketleme Projesi ekler. Bu proje, uygulamanızı dağıtım için bir MSIX paketi olarak derleme işlemini yapar. Daha basit bir kurulum tercih ediyorsanız, ayrı bir paketleme projesi korumak yerine tek projeli MSIX kullanın.

Bileşen ve test şablonları

Bu şablonlar bir WinUI uygulamasıyla birlikte çalışan kitaplıklar ve test projeleri oluşturur.

Şablon Language winapp CLI şablonu Açıklama
WinUI Sınıf Kitaplığı C# winui-lib WinUI uygulamaları arasında kod ve kullanıcı arabirimi bileşenlerini paylaşmak için .NET sınıf kitaplığı (DLL).
Windows Çalışma Zamanı Bileşeni C++ Mevcut değil Programlama dilinden bağımsız olarak WinUI tabanlı kullanıcı arabirimine sahip herhangi bir uygulama tarafından kullanılabilecek C++/WinRT dilinde yazılmış Windows Çalışma Zamanı bileşeni.
WinUI Birim Testi Uygulaması C# ve C++ winui-unittest (C#) Uygulamanız için otomatik testler yazmak ve çalıştırmak üzere bir MSTest projesi.

WinUI öğe şablonları

Öğe şablonları, mevcut bir WinUI project yeni dosyalar eklemenize olanak sağlar. Çözüm Gezgini'da projenize sağ tıklayın, Add>Yeni Öğe öğesini seçin ve WinUI sekmesini seçin.

WinUI öğe şablonlarınıWinUI item templatesWinUI item templates

Şablon Language Açıklama
Boş Sayfa C# ve C++ Microsoft.UI.Xaml.Controls.Page sınıfından türetilmiş yeni bir sayfa tanımlayan bir XAML dosyası ve kod dosyası ekler.
Boş Pencere C# ve C++ Microsoft.UI.Xaml.Window sınıfından türetilen yeni bir pencere tanımlayan bir XAML dosyası ve kod dosyası ekler.
İçerik iletişim kutusu C# Microsoft.UI.Xaml.Controls.ContentDialog sınıfından türetilmiş yeni bir iletişim kutusunu tanımlayan bir XAML dosyası ve kod dosyası ekler. Daha fazla bilgi için bkz. İletişim kutusu denetimleri.
Kaynak Sözlüğü C# ve C++ Boş, anahtarlı bir XAML kaynakları koleksiyonu ekler. Daha fazla bilgi için bkz. ResourceDictionary ve XAML kaynak başvuruları.
Kaynak Dosyası (.resw) C# ve C++ Uygulamanız için dize ve koşullu kaynakları depolamak için bir dosya ekler. Uygulamanızı yerelleştirmeye yardımcı olması için bu öğeyi kullanabilirsiniz. Daha fazla bilgi için bkz. Kullanıcı arabiriminizdeki dizeleri yerelleştirme ve uygulama paketi bildirimi.
Şablonlu Denetim C# ve C++ Varsayılan stile sahip şablonlu denetim oluşturmak için bir kod dosyası ekler. Şablonlu denetim Microsoft.UI.Xaml.Controls.Control sınıfından türetilir.

Bu öğe şablonunun nasıl kullanılacağını gösteren bir kılavuz için bkz. XAML şablonlu denetimleri oluşturma. Şablonlu denetimler hakkında daha fazla bilgi için bkz. Özel XAML Denetimleri.
Kullanıcı Denetimi C# ve C++ Microsoft.UI.Xaml.Controls.UserControl sınıfından türetilen bir kullanıcı denetimi oluşturmak için bir XAML dosyası ve kod dosyası ekler. Genellikle, kullanıcı denetimi ilgili mevcut denetimleri kapsüller ve kendi mantığını sağlar.

Kullanıcı denetimleri hakkında daha fazla bilgi için bkz. Özel XAML Denetimleri.

Bu öğeleri bir C# projesinde komut satırından eklemek için, dotnet new winui-page -n SettingsPage ile eşleşen öğe şablonunu, örneğin dotnet new, kullanın. Tüm öğe şablonlarını görmek için dotnet new list winui komutunu çalıştırın.

Ayrıca bakınız