You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/xaml-tools/xaml-hot-reload.md
+12-9Lines changed: 12 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -1,21 +1,22 @@
1
1
---
2
2
title: "Write and debug XAML code by using XAML Hot Reload"
3
3
description: "XAML Hot Reload, or XAML edit and continue, allows you to make changes to your XAML code while running apps"
4
-
ms.date: 09/21/2021
4
+
ms.date: 09/22/2021
5
5
ms.topic: conceptual
6
6
helpviewer_keywords:
7
7
- "xaml edit and continue"
8
8
- "xaml hot reload"
9
9
author: TerryGLee
10
10
ms.author: tglee
11
11
manager: jmartens
12
+
ms.custom: "contperf-fy22q1"
12
13
ms.technology: vs-xaml-tools
13
14
ms.workload:
14
15
- "multiple"
15
16
---
16
-
# Write and debug your WPF and UWP apps with XAML Hot Reload in Visual Studio
17
+
# XAML Hot Reload: Write and debug your WPF and UWP apps while they're running
17
18
18
-
With XAML Hot Reload, you can make changes to your XAML code while your app is running. You can use XAML Hot Reload to incrementally build and test XAML code with the benefit of the running app's data context, authentication state, and other real-world complexity that's hard to simulate during design-time.
19
+
With XAML Hot Reload, you can incrementally build and test XAML code with the benefit of the running app's data context, authentication state, and other real-world complexity that's hard to simulate during design-time.
19
20
20
21
> [!TIP]
21
22
> If you've arrived here by way of the XAML Hot Reload user interface (UI), welcome! You're in the right place to learn more about XAML Hot Reload. But, if you need help troubleshooting XAML Hot Reload, see [Troubleshooting XAML Hot Reload](xaml-hot-reload-troubleshooting.md) instead.
@@ -28,13 +29,13 @@ Available in both Visual Studio and Blend for Visual Studio, XAML Hot Reload is
28
29
29
30
|Supported Application Types|Operating System and Tools|
30
31
|-|-|-|
31
-
|Windows Presentation Foundation (WPF) |.NET Framework 4.6+ and .NET Core</br>Windows 7 and above|
32
-
|Universal Windows apps (UWP)|Windows 10 and above, with the [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk) 14393+ |
32
+
|Windows Presentation Foundation (WPF) |.NET Framework 4.6+ and .NET Core</br>Windows 7 and later|
33
+
|Universal Windows apps (UWP)|Windows 10 and later, with the [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk) 14393+ |
33
34
34
35
> [!NOTE]
35
36
> If you are using Xamarin.Forms, see [XAML Hot Reload for Xamarin.Forms](/xamarin/xamarin-forms/xaml/hot-reload).
36
37
37
-
The following animation shows an instance of using Live Visual Tree to open some source code and then using XAML Hot Reload to change the button text and button color.
38
+
The following animation shows an instance of using Live Visual Tree to open some source code and then using XAML Hot Reload to change the text and color of a button.
38
39
39
40
:::image type="content" source="../debugger/media/xaml-hot-reload-using.gif" alt-text="An animation of the Live Visual Tree opening source code and using XAML Hot Reload to change UI elements.":::
40
41
@@ -48,12 +49,12 @@ The following are known limitations of XAML Hot Reload. To work around any limit
48
49
|Limitation|WPF|UWP|Notes|
49
50
|-|-|-|-|
50
51
|Wiring events to controls while the app is running|Not Supported|Not supported|See error: *Ensure Event Failed*. Note that in WPF you can reference an existing event handler. In UWP apps, referencing an existing event handler is not supported.|
51
-
|Creating resource objects in a resource dictionary such as those in your app's Page/Window or *App.xaml*|Supported starting in Visual Studio 2019 Update 2|Supported|Example: adding a `SolidColorBrush` into a resource dictionary for use as a `StaticResource`.</br>Note: Static resources, style converters, and other elements written into a resource dictionary can be applied/used while using XAML Hot Reload. Only the creation of the resource is not supported.</br> Changing the resource dictionary `Source` property.|
52
+
|Creating resource objects in a resource dictionary such as those in your app's Page/Window or *App.xaml*|Supported starting in Visual Studio 2019 [version 16.2](/visualstudio/releases/2019/release-notes-v16.2) and later|Supported|Examples: <br>- Adding a `SolidColorBrush` into a resource dictionary for use as a `StaticResource`.</br>Note: Static resources, style converters, and other elements written into a resource dictionary can be applied/used while using XAML Hot Reload. Only the creation of the resource is not supported.</br> - Changing the resource dictionary `Source` property.|
52
53
|Adding new controls, classes, windows, or other files to your project while the app is running|Not Supported|Not Supported|None|
|Changing data binding that uses the {x:Bind} markup extension|N/A|Supported starting in Visual Studio 2019|This requires Windows 10 version 1809 (build 10.0.17763). Not supported in Visual Studio 2017 or previous versions.|
55
56
|Changing x:Uid directives is not supported|N/A|Not Supported|None|
56
-
|Using multiple processes | Supported | Supported | Supported in Visual Studio 2019 [version 16.6](/visualstudio/releases/2019/release-notes-v16.6) and later |
57
+
|Using multiple processes | Supported | Supported | Supported in Visual Studio 2019 [version 16.6](/visualstudio/releases/2019/release-notes-v16.6) and later.|
57
58
58
59
## Error messages
59
60
@@ -62,7 +63,9 @@ You might come across the following errors while using XAML Hot Reload.
62
63
|Error message|Description|
63
64
|-|-|
64
65
|Ensure Event Failed|Error indicates you are attempting to wire an event to one of your controls, which isn't supported while your application is running.|
65
-
|This change is not supported by XAML Hot Reload and will not be applied during the debugging session.|Error indicates that the change you are attempting is not supported by XAML Hot Reload. Stop the debugging session, make the change, and then restart the debugging session. If you find an unsupported scenario that you'd like to see supported, use our new "Suggest a feature" option in the [Visual Studio Developer Community](https://aka.ms/feedback/suggest?space=8). |
66
+
|This change is not supported by XAML Hot Reload and will not be applied during the debugging session.|Error indicates that the change you are attempting is not supported by XAML Hot Reload. Stop the debugging session, make the change, and then restart the debugging session. |
67
+
68
+
If you find an unsupported scenario that you'd like to see supported, let us know by using our [Suggest a feature](../ide/suggest-a-feature.md) option.
0 commit comments