Skip to content

Commit 2dd7f15

Browse files
gewarrengewarren
authored
Update what's new for RC 1 (#37011)
1 parent e66877b commit 2dd7f15

File tree

9 files changed

+267
-82
lines changed

9 files changed

+267
-82
lines changed

‎docs/core/project-sdk/msbuild-props.md‎

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -914,8 +914,9 @@ To remove this warning and continue to use the version of code analyzers in the
914914

915915
## Runtime configuration properties
916916

917-
You can configure some run-time behaviors by specifying MSBuild properties in the project file of the app. For information about other ways of configuring run-time behavior, see [Runtime configuration settings](../runtime-config/index.md).
917+
You can configure some runtime behaviors by specifying MSBuild properties in the project file of the app. For information about other ways of configuring runtime behavior, see [Runtime configuration settings](../runtime-config/index.md).
918918

919+
- [AutoreleasePoolSupport](#autoreleasepoolsupport)
919920
- [ConcurrentGarbageCollection](#concurrentgarbagecollection)
920921
- [InvariantGlobalization](#invariantglobalization)
921922
- [PredefinedCulturesOnly](#predefinedculturesonly)
@@ -926,6 +927,18 @@ You can configure some run-time behaviors by specifying MSBuild properties in th
926927
- [TieredCompilation](#tieredcompilation)
927928
- [TieredCompilationQuickJit](#tieredcompilationquickjit)
928929
- [TieredCompilationQuickJitForLoops](#tieredcompilationquickjitforloops)
930+
- [TieredPGO](#tieredpgo)
931+
- [UseWindowsThreadPool](#usewindowsthreadpool)
932+
933+
### AutoreleasePoolSupport
934+
935+
The `AutoreleasePoolSupport` property configures whether each managed thread receives an implicit [NSAutoreleasePool](https://developer.apple.com/documentation/foundation/nsautoreleasepool) when running on a supported macOS platform. For more information, see [`AutoreleasePool` for managed threads](../runtime-config/threading.md#autoreleasepool-for-managed-threads).
936+
937+
```xml
938+
<PropertyGroup>
939+
<AutoreleasePoolSupport>true</AutoreleasePoolSupport>
940+
</PropertyGroup>
941+
```
929942

930943
### ConcurrentGarbageCollection
931944

@@ -1029,6 +1042,26 @@ The `TieredCompilationQuickJitForLoops` property configures whether the JIT comp
10291042
</PropertyGroup>
10301043
```
10311044

1045+
### TieredPGO
1046+
1047+
The `TieredPGO` property controls whether dynamic or tiered profile-guided optimization (PGO) is enabled. Set the value to `true` to enable tiered PGO. For more information, see [Profile-guided optimization](../runtime-config/compilation.md#profile-guided-optimization).
1048+
1049+
```xml
1050+
<PropertyGroup>
1051+
<TieredPGO>true</TieredPGO>
1052+
</PropertyGroup>
1053+
```
1054+
1055+
### UseWindowsThreadPool
1056+
1057+
The `UseWindowsThreadPool` property configures whether thread pool thread management is delegated to the Windows thread pool (Windows only). The default value is `false`, in which case the .NET thread pool is used. For more information, see [Windows thread pool](../runtime-config/threading.md#windows-thread-pool).
1058+
1059+
```xml
1060+
<PropertyGroup>
1061+
<UseWindowsThreadPool>true</UseWindowsThreadPool>
1062+
</PropertyGroup>
1063+
```
1064+
10321065
## Reference-related properties
10331066

10341067
The following MSBuild properties are documented in this section:

‎docs/core/runtime-config/compilation.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Compilation config settings
3-
description: Learn about run-time settings that configure how the JIT compiler works for .NET Core apps.
3+
description: Learn about run-time settings that configure how the JIT compiler works for .NET apps.
44
ms.date: 10/29/2021
55
ms.topic: reference
66
---

‎docs/core/runtime-config/debugging-profiling.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Debugging profiling config settings
3-
description: Learn about run-time settings that configure debugging and profiling for .NET Core apps.
3+
description: Learn about run-time settings that configure debugging and profiling for .NET apps.
44
ms.date: 11/27/2019
55
ms.topic: reference
66
---

‎docs/core/runtime-config/garbage-collector.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Garbage collector config settings
3-
description: Learn about run-time settings for configuring how the garbage collector manages memory for .NET Core apps.
3+
description: Learn about run-time settings for configuring how the garbage collector manages memory for .NET apps.
44
ms.date: 04/20/2022
55
ms.topic: reference
66
---

‎docs/core/runtime-config/networking.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Networking config settings
3-
description: Learn about run-time settings that configure networking for .NET Core apps.
3+
description: Learn about run-time settings that configure networking for .NET apps.
44
ms.date: 11/27/2019
55
ms.topic: reference
66
---

‎docs/core/runtime-config/threading.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Threading config settings
3-
description: Learn about the settings that configure threading for .NET Core apps.
3+
description: Learn about the settings that configure threading for .NET apps.
44
ms.date: 11/04/2021
55
ms.topic: reference
66
---
@@ -99,7 +99,7 @@ Project file:
9999
- For projects on Windows, configures whether thread pool thread management is delegated to the Windows thread pool.
100100
- If you omit this setting or the platform is not Windows, the .NET thread pool is used instead.
101101
- Only applications published with Native AOT on Windows use the Windows thread pool by default, for which you can opt to use the .NET thread pool instead by disabling the config setting.
102-
- The Windows thread pool may perform better in some cases, such as in cases where the minimum number of threads is configured to a high value, or when the Windows thread pool is already being heavily used by the app. There may also be cases where the .NET thread pool performs better, such as in heavy I/O handling on larger machines. It is advisable to check performance metrics when changing this config setting.
102+
- The Windows thread pool may perform better in some cases, such as in cases where the minimum number of threads is configured to a high value, or when the Windows thread pool is already being heavily used by the app. There may also be cases where the .NET thread pool performs better, such as in heavy I/O handling on larger machines. It's advisable to check performance metrics when changing this config setting.
103103
- Some APIs are not supported when using the Windows thread pool, such as <xref:System.Threading.ThreadPool.SetMinThreads%2A?displayProperty=nameWithType>, <xref:System.Threading.ThreadPool.SetMaxThreads%2A?displayProperty=nameWithType>, and <xref:System.Threading.ThreadPool.BindHandle%28System.Runtime.InteropServices.SafeHandle%29?displayProperty=nameWithType>. Thread pool config settings for minimum and maximum threads are also not effective. An alternative to <xref:System.Threading.ThreadPool.BindHandle%28System.Runtime.InteropServices.SafeHandle%29?displayProperty=nameWithType> is the <xref:System.Threading.ThreadPoolBoundHandle> class.
104104

105105
| | Setting name | Values | Version introduced |

‎docs/core/runtime-config/wpf.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: WPF config settings
3+
description: Learn about the settings that configure WPF for .NET apps.
4+
ms.date: 09/08/2023
5+
ms.topic: reference
6+
---
7+
# Runtime configuration options for WPF
8+
9+
This article details the settings you can use to configure Windows Presentation Framework (WPF) in .NET.
10+
11+
[!INCLUDE [complus-prefix](../../../includes/complus-prefix.md)]
12+
13+
## Hardware acceleration in RDP
14+
15+
- Configures whether hardware acceleration is used for WPF apps that are accessed through Remote Desktop Protocol (RDP). Hardware acceleration refers to the use of a computer's graphics processing unit (GPU) to speed up the rendering of graphics and visual effects in an application. This can result in improved performance and more seamless, responsive graphics.
16+
- If you omit this setting, graphics are rendered by software instead. This is equivalent to setting the value to `false`.
17+
18+
| | Setting name | Values | Version introduced
19+
| - | - | - | - |
20+
| **runtimeconfig.json** | `Switch.System.Windows.Media.EnableHardwareAccelerationInRdp` | `true` - enabled<br/>`false` - disabled | .NET 8 |
21+
| **Environment variable** | N/A | N/A | |
22+
23+
You can also configure this setting by adding a `RuntimeHostConfigurationOption` item to your project file.
24+
25+
```xml
26+
<ItemGroup>
27+
<RuntimeHostConfigurationOption Include="Switch.System.Windows.Media.EnableHardwareAccelerationInRdp" Value="true" />
28+
</ItemGroup>
29+
```

0 commit comments

Comments
 (0)