XAML Çalışırken Yeniden Yükleme sorunlarını giderme

Şunlar için geçerlidir: Visual Studio 2019 ve sonraki sürümleri

Bu sorun giderme kılavuzu, XAML Çalışırken Yeniden Yükleme düzgün çalışmasını engelleyen sorunların çoğunu çözmeniz gereken ayrıntılı yönergeler içerir.

XAML Çalışırken Yeniden Yükleme WPF ve UWP uygulamaları için desteklenir. İşletim sistemi ve araç gereksinimleri hakkında ayrıntılı bilgi için bkz. XAML Çalışırken Yeniden Yükleme ile çalışan XAML kodunu yazma ve hata ayıklama.

Çalışırken Yeniden Yükleme kullanılamıyorsa

Uygulamanızda hata ayıklarken uygulama içi araç çubuğunda iletiyi Hot Reload is not available görürseniz, sorunu çözmek için bu makalede açıklanan yönergeleri izleyin.

XAML Çalışırken Yeniden Yükleme etkinleştirildiğini doğrulama

Özellik, Visual Studio 2019 ve sonraki sürümlerde varsayılan olarak etkindir. Uygulamanızda hata ayıklamaya başladığınızda, XAML Çalışırken Yeniden Yükleme kullanılabilir olduğunu onaylayan uygulama içi araç çubuğunu gördüğünüzden emin olun.

Visual Studio 2019:

Visual Studio 2022:

Uygulama içi araç çubuğunu görmüyorsanız Visual Studio menü çubuğundan Hata Ayıklama>Seçenekleri>XAML Çalışırken Yeniden Yükleme'ni seçin. Ardından, Seçenekler iletişim kutusunda XAML Çalışırken Yeniden Yükleme etkinleştir seçeneğinin belirlendiğinden emin olun.

İşleme Ekle yerine Hata Ayıklamayı Başlat'ı kullandığınızı doğrulayın

XAML Çalışırken Yeniden Yükleme, ortam değişkeninin ENABLE_XAML_DIAGNOSTICS_SOURCE_INFO uygulama başlatıldığında olarak ayarlanmasını 1 gerektirir. Visual Studio, Hata AyıklamaYı>Başlat Hata Ayıklama (veya F5) komutunun bir parçası olarak değeri otomatik olarak ayarlar. Bunun yerine XAML Çalışırken Yeniden Yükleme İşleme>Ekle komutuyla kullanmak istiyorsanız ortam değişkenini kendiniz ayarlayın.

Not

Ortam değişkeni ayarlamak için Başlat düğmesini kullanarak ortam değişkenini arayın ve Sistem ortam değişkenlerini düzenle'yi seçin. Açılan iletişim kutusunda Ortam Değişkenleri'ni seçin, ardından bunu bir kullanıcı değişkeni olarak ekleyin ve değerini olarak 1ayarlayın. Temizlemek için hata ayıklamayı bitirdiğinizde değişkeni kaldırın.

MSBuild özelliklerinizin doğru olduğunu doğrulayın

Varsayılan olarak, kaynak bilgileri hata ayıklama yapılandırmasına dahil edilir. Proje dosyalarınızdaki ( *.csproj gibi) MSBuild özellikleri tarafından denetlenir. WPF için özelliği, olarak ayarlanması Truegereken şeklindedirXamlDebuggingInformation. UWP için özelliği, olarak ayarlanması Falsegereken şeklindedirDisableXbfLineInfo. Örneğin:

WPF:

<XamlDebuggingInformation>True</XamlDebuggingInformation>

UWP:

<DisableXbfLineInfo>False</DisableXbfLineInfo>

Doğru derleme yapılandırma adını kullandığınızı doğrulayın

XAML Çalışırken Yeniden Yükleme desteklemek için doğru MSBuild özelliğini el ile ayarlamanız (önceki bölüme bakın) veya varsayılan derleme yapılandırma adını (Hata Ayıklama) kullanmanız gerekir. MSBuild özelliğini doğru ayarlamazsanız, özel derleme yapılandırma adı çalışmaz ve Yayın derlemesi çalışmaz.

Programınızın yükseltilmiş çalışmadığından emin olun

XAML Çalışırken Yeniden Yükleme, yükseltilmiş/yönetici olarak çalıştırılan uygulamalarda desteklenmez.

XAML dosyanızda hata olmadığını doğrulayın

XAML dosyanız Hata Listesi'nde hatalar gösteriyorsa, XAML Çalışırken Yeniden Yükleme çalışmayabilir.

Visual Studio 2022'de kaynak başvurularını ve stillerini güncelleştirmek için daha kapsamlı aramayı etkinleştirme

ortam değişkenini XAML_HOT_RELOAD_ACCURACY_OVER_PERF olarak ayarlamak 1 , WPF uygulamalarında kaynak başvurularını ve stillerini güncelleştirmek için daha kapsamlı bir arama sağlar. Üçüncü taraf araç setleri kullanan uygulamalar gibi bazı uygulamaların XAML Çalışırken Yeniden Yükleme önemli gecikmelerle karşılaşabileceğini unutmayın. Gecikme oluştuğunda, Düzenleyici durum çubuğunda bir Çalışırken Yeniden Yükleme ilerleme zamanlayıcısı görüntülenir.

Bilinen sınırlamalar

XAML Çalışırken Yeniden Yükleme bilinen sınırlamaları aşağıdadır. Karşılaşacağınız sınırlamaları geçici olarak çözmek için hata ayıklayıcıyı durdurmanız ve ardından işlemi tamamlamanız gerekir.

Sınırlama	WPF	UWP	Notlar
Uygulama çalışırken olayları denetimlere bağlama	Desteklenmiyor	Desteklenmiyor	Bkz. hata: Olayın Başarısız Olduğundan Emin Olun. WPF'de var olan bir olay işleyiciye başvurabilirsiniz. UWP uygulamalarında mevcut bir olay işleyiciye başvurmak desteklenmez.
Uygulamanızın Page/Window veya App.xaml gibi bir kaynak sözlüğünde kaynak nesneleri oluşturma	Visual Studio 2019 sürüm 16.2 ve sonrasından itibaren desteklenir	Destekleniyor	Örnekler: - SolidColorBrush Olarak kullanmak üzere kaynak sözlüğüne eklemeStaticResource. Not: Statik kaynaklar, stil dönüştürücüleri ve kaynak sözlüğüne yazılan diğer öğeler XAML Çalışırken Yeniden Yükleme kullanılırken uygulanabilir/kullanılabilir. Yalnızca kaynağın oluşturulması desteklenmez. - Kaynak sözlüğü Source özelliğini değiştirme.
Uygulama çalışırken projenize yeni denetimler, sınıflar, pencereler veya başka dosyalar ekleme	Desteklenmiyor	Desteklenmiyor	Yok
NuGet paketlerini yönetme (paketleri ekleme/kaldırma/güncelleştirme)	Desteklenmiyor	Desteklenmiyor	Yok
{x:Bind} işaretleme uzantısını kullanan veri bağlaması değiştiriliyor	Yok	Visual Studio 2019'dan itibaren desteklenir	Bunun için Windows 10 sürüm 1809 (derleme 10.0.17763) ve üzeri gerekir. Visual Studio 2017 veya önceki sürümlerde desteklenmez.
x:Uid yönergelerini değiştirme	Yok	Desteklenmiyor	Yok
Birden çok işlem kullanma	Destekleniyor	Destekleniyor	Visual Studio 2019 sürüm 16.6 ve sonraki sürümlerde desteklenir.
Temalardaki Stilleri Düzenleme\generic.xaml	Desteklenmiyor	Desteklenmiyor	XAML Çalışırken Yeniden Yükleme yeni stiller oluşturur; özgün stiller korumalıdır. Platformlar, denetimlere uygulandıktan sonra generic.xaml'deki stilleri önbelleğe alır ve bu da bunların değiştirilmesi için erişilemez olmasını sağlar.

Yaygın hata iletileri

XAML Çalışırken Yeniden Yükleme kullanırken aşağıdaki hatalara karşılaşabilirsiniz.

Hata iletisi	Açıklama
Olayın Başarısız Olduğundan Emin Olun	Hata, uygulamanız çalışırken desteklenmeyen bir olayı denetimlerinizden birine bağlamaya çalıştığınızı gösterir.
Bu değişiklik XAML Çalışırken Yeniden Yükleme tarafından desteklenmez ve hata ayıklama oturumu sırasında uygulanmaz.	Hata, denediğiniz değişikliğin XAML Çalışırken Yeniden Yükleme tarafından desteklenmediğini gösterir. Hata ayıklama oturumunu durdurun, değişikliği yapın ve hata ayıklama oturumunu yeniden başlatın.

Desteklendiğini görmek istediğiniz desteklenmeyen bir senaryo bulursanız Özellik önerin seçeneğimizi kullanarak bize bildirin.