Skip to content

Commit e8d2177

Browse files
authored
update XAML Hot Reload intro section (#8722)
* update XAML Hot Reload intro section * revise animation link + minor edits * Acrolinx pass
1 parent d7bfad1 commit e8d2177

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

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

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: "Write and debug XAML using XAML Hot Reload"
2+
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/23/2020
4+
ms.date: 09/21/2021
55
ms.topic: conceptual
66
helpviewer_keywords:
77
- "xaml edit and continue"
@@ -13,14 +13,14 @@ ms.technology: vs-xaml-tools
1313
ms.workload:
1414
- "multiple"
1515
---
16-
# Write and debug running XAML code with XAML Hot Reload in Visual Studio
16+
# Write and debug your WPF and UWP apps with XAML Hot Reload in Visual Studio
1717

18-
XAML Hot Reload helps you build your WPF or UWP app user interface (UI) by letting you make changes to XAML code while your app is running. Hot Reload is available in both Visual Studio and Blend for Visual Studio. This feature enables you 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. If you need help troubleshooting XAML Hot Reload, see [Troubleshooting XAML Hot Reload](xaml-hot-reload-troubleshooting.md) instead.
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.
1919

20-
> [!NOTE]
21-
> If you are using Xamarin.Forms, see [XAML Hot Reload for Xamarin.Forms](/xamarin/xamarin-forms/xaml/hot-reload).
20+
> [!TIP]
21+
> 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.
2222
23-
XAML Hot Reload is especially helpful in these scenarios:
23+
Available in both Visual Studio and Blend for Visual Studio, XAML Hot Reload is especially helpful in these scenarios:
2424

2525
* Fixing UI problems found in your XAML code after the app was started in debug mode.
2626

@@ -31,12 +31,15 @@ XAML Hot Reload is especially helpful in these scenarios:
3131
|Windows Presentation Foundation (WPF) |.NET Framework 4.6+ and .NET Core</br>Windows 7 and above |
3232
|Universal Windows apps (UWP)|Windows 10 and above, with the [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk) 14393+ |
3333

34-
The following illustration shows the use of the Live Visual Tree to open your source code, and then XAML Hot Reload to change the button text and button color.
34+
> [!NOTE]
35+
> If you are using Xamarin.Forms, see [XAML Hot Reload for Xamarin.Forms](/xamarin/xamarin-forms/xaml/hot-reload).
36+
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.
3538

36-
![XAML Hot Reload](../debugger/media/xaml-hot-reload-using.gif)
39+
:::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.":::
3740

3841
> [!NOTE]
39-
> Visual Studio XAML Hot Reload is currently only supported when running your application in Visual Studio or Blend for Visual Studio with the debugger attached (**F5** or **Start debugging**). You can't enable this experience by using [Attach to process](../debugger/attach-to-running-processes-with-the-visual-studio-debugger.md) unless you [manually set an environment variable](xaml-hot-reload-troubleshooting.md#verify-that-you-use-start-debugging-rather-than-attach-to-process).
42+
> Visual Studio XAML Hot Reload is currently supported only when you're running an application in Visual Studio or Blend for Visual Studio with the debugger attached (**F5** or **Start debugging**). You can't enable this experience by using [Attach to process](../debugger/attach-to-running-processes-with-the-visual-studio-debugger.md) unless you [manually set an environment variable](xaml-hot-reload-troubleshooting.md#verify-that-you-use-start-debugging-rather-than-attach-to-process).
4043
4144
## Known limitations
4245

@@ -50,11 +53,11 @@ The following are known limitations of XAML Hot Reload. To work around any limit
5053
|Managing NuGet packages (adding/removing/updating packages)|Not Supported|Not Supported|None|
5154
|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.|
5255
|Changing x:Uid directives is not supported|N/A|Not Supported|None|
53-
|Multiple processes | Supported | Supported | Supported in Visual Studio 2019 [version 16.6](/visualstudio/releases/2019/release-notes-v16.6) and later |
56+
|Using multiple processes | Supported | Supported | Supported in Visual Studio 2019 [version 16.6](/visualstudio/releases/2019/release-notes-v16.6) and later |
5457

5558
## Error messages
5659

57-
You may come across the following errors while using XAML Hot Reload.
60+
You might come across the following errors while using XAML Hot Reload.
5861

5962
|Error message|Description|
6063
|-|-|

0 commit comments

Comments
 (0)