XAML Hot Reload: Schreiben und Debuggen Ihrer WPF- und UWP-Apps während der Ausführung

Mit XAML Hot Reload können Sie XAML-Code inkrementell erstellen und testen. Dabei profitieren Sie vom Datenkontext, dem Authentifizierungszustand und anderen realen Komplexitäten der ausgeführten App, die zur Entwurfszeit schwer zu simulieren sind.

Tipp

Wenn Sie über die benutzeroberfläche (UI) hier XAML Hot Reload sind, willkommen! Sie sind am richtigen Ort, um mehr über XAML Hot Reload. Wenn Sie jedoch Hilfe bei der Problembehandlung XAML Hot Reload, finden Sie weitere Informationen unter Problembehandlung XAML Hot Reload Problembehandlung.

Sowohl in Visual Studio als auch Blend für Visual Studio ist XAML Hot Reload in diesen Szenarien besonders hilfreich:

  • Beheben von Problemen mit der Benutzeroberfläche, die in Ihrem XAML-Code gefunden wurden, nachdem die App im Debugmodus gestartet wurde.

  • Erstellen einer neuen Benutzeroberflächenkomponente für eine App, die sich in der Entwicklung befindet, während sie gleichzeitig den Laufzeitkontext Ihrer App nutzt.

Unterstützte Anwendungstypen Betriebssystem und Tools
Windows Presentation Foundation (WPF) .NET Framework 4.6 und .NET Core
Windows 7 und höher
Universelle Windows-Apps (UWP) Windows 10 und höher mit dem Windows 10 SDK 14393 und höher

Hinweis

Wenn Sie Xamarin.Forms verwenden, finden Sie weitere XAML Hot Reload für Xamarin.Forms.

Die folgende Animation zeigt eine Instanz von mithilfe der visuellen Livestruktur, um Quellcode zu öffnen, und verwendet dann XAML Hot Reload, um den Text und die Farbe einer Schaltfläche zu ändern.

Eine Animation des Quellcodes für die visuelle Livestruktur und die Verwendung XAML Hot Reload zum Ändern von Benutzeroberflächenelementen.

Hinweis

Visual Studio XAML Hot Reload wird derzeit nur unterstützt, wenn Sie eine Anwendung in Visual Studio oder Blend für Visual Studio mit angefügten Debugger ausführen (F5 oder Debuggen starten). Sie können diese Umgebung nicht aktivieren, indem Sie An den Prozess anhängen verwenden, es sei denn, Sie legen manuell eine Umgebungsvariable fest.

Bekannte Einschränkungen

Im Folgenden finden Sie bekannte Einschränkungen XAML Hot Reload. Um alle Einschränkungen zu umgehen, auf die Sie laufen, beenden Sie einfach den Debugger, und schließen Sie dann den Vorgang ab.

Einschränkung WPF UWP Notizen
Verkabeln von Ereignissen an Steuerelemente, während die App ausgeführt wird Nicht unterstützt Nicht unterstützt Siehe Fehler: Sicherstellen, dass das Ereignis fehlgeschlagen ist. Beachten Sie, dass Sie in WPF auf einen vorhandenen Ereignishandler verweisen können. In UWP-Apps wird das Verweisen auf einen vorhandenen Ereignishandler nicht unterstützt.
Erstellen von Ressourcenobjekten in einem Ressourcenwörterbuch, z. B. in seiten-/fenster- oder app.xaml-Dateien Ihrer App Unterstützt ab Visual Studio 2019 Version 16.2 und höher Unterstützt Beispiele:
– Hinzufügen eines SolidColorBrush zu einem Ressourcenwörterbuch zur Verwendung als StaticResource .
Hinweis: Statische Ressourcen, Stilkonverter und andere Elemente, die in ein Ressourcenwörterbuch geschrieben werden, können angewendet/verwendet werden, während sie XAML Hot Reload. Nur die Erstellung der Ressource wird nicht unterstützt.
– Ändern der Eigenschaft des Source Ressourcenwörterbuchs.
Hinzufügen neuer Steuerelemente, Klassen, Fenster oder anderer Dateien zu Ihrem Projekt, während die App ausgeführt wird Nicht unterstützt Nicht unterstützt Keiner
Verwalten NuGet Paketen (Hinzufügen/Entfernen/Aktualisieren von Paketen) Nicht unterstützt Nicht unterstützt Keiner
Ändern der Datenbindung, die die {x:Bind}-Markuperweiterung verwendet Unterstützt ab Visual Studio 2019 Dies erfordert Windows 10 Version 1809 (Build 10.0.17763). Wird in Visual Studio 2017 oder früheren Versionen nicht unterstützt.
Das Ändern von x:Uid-Anweisungen wird nicht unterstützt. NICHT ZUTREFFEND Nicht unterstützt Keiner
Verwenden mehrerer Prozesse Unterstützt Unterstützt Wird in Visual Studio 2019 Version 16.6 und höher unterstützt.

Fehlermeldungen

Bei der Verwendung von können die folgenden Fehler XAML Hot Reload.

Fehlermeldung BESCHREIBUNG
Sicherstellen, dass das Ereignis fehlgeschlagen ist Fehler gibt an, dass Sie versuchen, ein Ereignis mit einem Ihrer Steuerelemente zu verkabeln. Dies wird während der Ausführung der Anwendung nicht unterstützt.
Diese Änderung wird von der XAML Hot Reload nicht unterstützt und während der Debugsitzung nicht angewendet. Fehler gibt an, dass die änderung, die Sie versuchen, von der XAML Hot Reload. Beenden Sie die Debugsitzung, nehmen Sie die Änderung vor, und starten Sie die Debugsitzung neu.

Wenn Sie ein nicht unterstütztes Szenario finden, das unterstützt werden soll, teilen Sie uns dies mit, indem Sie die Option Feature vorschlagen verwenden.

Weitere Informationen