Skip to content

Commit da5efd7

Browse files
authored
update metadata and make minor edits to text (#8727)
* update metadata and make minor edits to text * revise text for clarity
1 parent 022ac34 commit da5efd7

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

docs/xaml-tools/xaml-hot-reload.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,22 @@
11
---
22
title: "Write and debug XAML code by using XAML Hot Reload"
33
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
55
ms.topic: conceptual
66
helpviewer_keywords:
77
- "xaml edit and continue"
88
- "xaml hot reload"
99
author: TerryGLee
1010
ms.author: tglee
1111
manager: jmartens
12+
ms.custom: "contperf-fy22q1"
1213
ms.technology: vs-xaml-tools
1314
ms.workload:
1415
- "multiple"
1516
---
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
1718

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.
1920

2021
> [!TIP]
2122
> 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
2829

2930
|Supported Application Types|Operating System and Tools|
3031
|-|-|-|
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+ |
3334

3435
> [!NOTE]
3536
> If you are using Xamarin.Forms, see [XAML Hot Reload for Xamarin.Forms](/xamarin/xamarin-forms/xaml/hot-reload).
3637
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.
3839

3940
:::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.":::
4041

@@ -48,12 +49,12 @@ The following are known limitations of XAML Hot Reload. To work around any limit
4849
|Limitation|WPF|UWP|Notes|
4950
|-|-|-|-|
5051
|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.|
5253
|Adding new controls, classes, windows, or other files to your project while the app is running|Not Supported|Not Supported|None|
5354
|Managing NuGet packages (adding/removing/updating packages)|Not Supported|Not Supported|None|
5455
|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.|
5556
|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. |
5758

5859
## Error messages
5960

@@ -62,7 +63,9 @@ You might come across the following errors while using XAML Hot Reload.
6263
|Error message|Description|
6364
|-|-|
6465
|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.
6669

6770
## See also
6871

0 commit comments

Comments
 (0)