Kbridge/main/fix target framework references (#5185)

Karl-Bridge-Microsoft · web-flow · commit a3db3dd1caa4 · 2025-02-18T15:37:38.000-08:00
* fix-target-framework-references

* RuntimeIdentifiers
diff --git a/hub/apps/design/shell/tiles-and-notifications/secondary-tiles-desktop-pinning.md b/hub/apps/design/shell/tiles-and-notifications/secondary-tiles-desktop-pinning.md
@@ -37,8 +37,8 @@ If you're using WPF or WinForms, and you haven't packaged your app with the Desk
 
     ```xml
     <PropertyGroup>
-      <!-- You can also target other versions of the Windows SDK and .NET; for example, "net6.0-windows10.0.19041.0" -->
-      <TargetFramework>net6.0-windows10.0.22000.0</TargetFramework>
+      <!-- You can also target other versions of the Windows SDK and .NET; for example, "net8.0-windows10.0.19041.0" -->
+      <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     </PropertyGroup>
     ```
 
diff --git a/hub/apps/desktop/modernize/desktop-to-uwp-enhance.md b/hub/apps/desktop/modernize/desktop-to-uwp-enhance.md
@@ -35,24 +35,24 @@ This option is supported only in projects that use .NET 6 (or later) and target
     <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
         <OutputType>WinExe</OutputType>
-        <TargetFramework>net5.0</TargetFramework>
+        <TargetFramework>net8.0</TargetFramework>
       </PropertyGroup>
     </Project>
     ```
 
 2. Leaving all other settings as they are, replace the value of the **TargetFramework** element with one of the following strings:
 
-    * **net6.0-windows10.0.17763.0**: If your app targets Windows 10, version 1809.
-    * **net6.0-windows10.0.18362.0**: If your app targets Windows 10, version 1903.
-    * **net6.0-windows10.0.19041.0**: If your app targets Windows 10, version 2004.
-    * **net6.0-windows10.0.22000.0**: If your app targets initial release of Windows 11.
-    * **net6.0-windows10.0.22621.0**: If your app targets Windows 11, version 22H2.
-    * **net6.0-windows10.0.26100.0**: If your app targets Windows 11, version 24H2.
+    * **net8.0-windows10.0.17763.0**: If your app targets Windows 10, version 1809.
+    * **net8.0-windows10.0.18362.0**: If your app targets Windows 10, version 1903.
+    * **net8.0-windows10.0.19041.0**: If your app targets Windows 10, version 2004.
+    * **net8.0-windows10.0.22000.0**: If your app targets initial release of Windows 11.
+    * **net8.0-windows10.0.22621.0**: If your app targets Windows 11, version 22H2.
+    * **net8.0-windows10.0.26100.0**: If your app targets Windows 11, version 24H2.
 
     For example, the following element is for a project that targets Windows 10, version 2004.
 
     ```xml
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     ```
     
     In later versions of .NET, you can replace the value with the relevant version, for example **net8.0-windows10.0.19041.0**.
@@ -78,7 +78,7 @@ The **TargetPlatformMinVersion** can be overridden to be less than the **TargetP
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
   </PropertyGroup>
 </Project>
diff --git a/hub/apps/desktop/modernize/winrt-com-interop-csharp.md b/hub/apps/desktop/modernize/winrt-com-interop-csharp.md
@@ -30,7 +30,7 @@ For other .NET desktop project types&mdash;such as [Windows Presentation Foundat
 
     ```xml
     <PropertyGroup>
-      <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+      <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     </PropertyGroup>
     ```
 
diff --git a/hub/apps/develop/platform/csharp-winrt/create-windows-runtime-component-cswinrt.md b/hub/apps/develop/platform/csharp-winrt/create-windows-runtime-component-cswinrt.md
@@ -30,7 +30,7 @@ Begin by creating a new project in Visual Studio. Select the **Class Library** p
 
     ```xml
     <PropertyGroup>
-        <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+        <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
         <Platforms>x64</Platforms>
     </PropertyGroup>
     ```
diff --git a/hub/apps/develop/platform/csharp-winrt/index.md b/hub/apps/develop/platform/csharp-winrt/index.md
@@ -81,7 +81,7 @@ C#/WinRT uses the [LoadLibrary alternate search order](/windows/win32/dlls/dynam
 
   To address this error, edit your `<TargetFramework>` property to target a specific Windows version, for example:
   ```xml
-  <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
   ```
   Refer to the docs on [Calling Windows Runtime APIs](../../../desktop/modernize/desktop-to-uwp-enhance.md) for more details on specifying the `<TargetFramework>` property.
   
diff --git a/hub/apps/develop/platform/csharp-winrt/net-projection-from-cppwinrt-component.md b/hub/apps/develop/platform/csharp-winrt/net-projection-from-cppwinrt-component.md
@@ -126,7 +126,7 @@ Before you can invoke the `cswinrt.exe` tool to generate the projection assembly
 
     ```xml
     <PropertyGroup>
-      <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+      <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
       <!-- Set Platform to AnyCPU to allow consumption of the projection assembly from any architecture. -->
       <Platform>AnyCPU</Platform>
     </PropertyGroup>
diff --git a/hub/apps/package-and-deploy/project-properties.md b/hub/apps/package-and-deploy/project-properties.md
@@ -29,7 +29,7 @@ Here's an excerpt from a typical `.csproj` file for a C# WinUI 3 project showing
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
     ...
     <UseWinUI>true</UseWinUI>
diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md
@@ -111,12 +111,12 @@ The version numbers in your resulting `.csproj` will be slightly different, but
 ```xml
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     <Platform Condition=" '$(Platform)' == '' ">x86</Platform>
     <OutputType>WinExe</OutputType>
     <DefaultLanguage>en-US</DefaultLanguage>
     <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
-    <RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
+    <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
     <UseWinUI>true</UseWinUI>
     <ApplicationManifest>app.manifest</ApplicationManifest>
     <EnableMsixTooling>true</EnableMsixTooling>
diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/winforms-plus-winappsdk.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/winforms-plus-winappsdk.md
@@ -44,13 +44,13 @@ First we'll edit the project file.
 2. This step enables you to call [Windows Runtime (WinRT) APIs](/uwp/api/) (including [Windows App SDK APIs](/windows/windows-app-sdk/api/winrt/)). Inside the **PropertyGroup** element is the **TargetFramework** element, which is set to a value such as *net6.0*. Append to that target framework value a moniker (specifically, a [Target Framework Moniker](/windows/apps/desktop/modernize/desktop-to-uwp-enhance#net-6-and-later-use-the-target-framework-moniker-option)). For example, use the following if your app targets Windows 10, version 2004:
 
     ```xml
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     ```
 
 3. Also inside the **PropertyGroup** element, add a [RuntimeIdentifiers](/dotnet/core/project-sdk/msbuild-props#runtimeidentifiers) element, like this:
 
     ```xml
-    <RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
+    <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
     ```
 
 4. By default, a WinForms app is unpackaged (meaning that it isn't installed by using MSIX). An unpackaged app must initialize the Windows App SDK runtime before using any other feature of the Windows App SDK. You can do that automatically when your app starts via *auto-initialization*. You just set (also inside the **PropertyGroup** element) the `WindowsPackageType` project property appropriately, like this:
diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/wpf-plus-winappsdk.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/wpf-plus-winappsdk.md
@@ -44,13 +44,13 @@ First we'll edit the project file.
 2. This step enables you to call [Windows Runtime (WinRT) APIs](/uwp/api/) (including [Windows App SDK APIs](/windows/windows-app-sdk/api/winrt/)). Inside the **PropertyGroup** element is the **TargetFramework** element, which is set to a value such as *net6.0*. Append to that target framework value a moniker (specifically, a [Target Framework Moniker](/windows/apps/desktop/modernize/desktop-to-uwp-enhance#net-6-and-later-use-the-target-framework-moniker-option)). For example, use the following if your app targets Windows 10, version 2004:
 
     ```xml
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     ```
 
 3. Also inside the **PropertyGroup** element, add a [RuntimeIdentifiers](/dotnet/core/project-sdk/msbuild-props#runtimeidentifiers) element, as shown below. If you're targeting .NET 8 or later, then use the value `win-x86;win-x64;win-arm64` instead.
 
     ```xml
-    <RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
+    <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
     ```
 
 4. By default, a WPF app is unpackaged (meaning that it isn't installed by using MSIX). An unpackaged app must initialize the Windows App SDK runtime before using any other feature of the Windows App SDK. You can do that automatically when your app starts via *auto-initialization*. You just set (also inside the **PropertyGroup** element) the `WindowsPackageType` project property appropriately, like this:
diff --git a/hub/apps/windows-app-sdk/preview-experimental-unpackaged-tutorial.md b/hub/apps/windows-app-sdk/preview-experimental-unpackaged-tutorial.md
@@ -133,7 +133,7 @@ Follow these instructions to configure a C# project. Starting in [1.0 Preview 3]
     2. Replace the value of the **TargetFramework** element with a [Target Framework Moniker](../desktop/modernize/desktop-to-uwp-enhance.md#net-6-and-later-use-the-target-framework-moniker-option). For example, use the following if your app targets Windows 10, version 2004.
 
         ```xml
-        <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+        <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
         ```
 
     3. Save and close the project file.
@@ -217,7 +217,7 @@ Follow these instructions to configure a C# project that uses the [1.0 Experimen
     2. Replace the value of the **TargetFramework** element with a [Target Framework Moniker](../desktop/modernize/desktop-to-uwp-enhance.md#net-6-and-later-use-the-target-framework-moniker-option). For example, use the following if your app targets Windows 10, version 2004.
 
         ```xml
-        <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+        <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
         ```
 
     3. Save and close the project file.
diff --git a/hub/apps/windows-app-sdk/release-notes-archive/stable-channel-0.8.md b/hub/apps/windows-app-sdk/release-notes-archive/stable-channel-0.8.md
@@ -90,7 +90,7 @@ This is a servicing release of the Windows App SDK that includes several perform
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
         <OutputType>WinExe</OutputType>
-        <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+        <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
         <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
         <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
     <PropertyGroup>
diff --git a/hub/apps/windows-app-sdk/release-notes-archive/stable-channel-1.0.md b/hub/apps/windows-app-sdk/release-notes-archive/stable-channel-1.0.md
@@ -288,7 +288,7 @@ For more information, see [Manage resources with MRT Core](../mrtcore/mrtcore-ov
 - **Upgrading from .NET 5 to .NET 6**: When upgrading in the Visual Studio UI, you might run into build errors. As a workaround, manually update your project file's `TargetFrameworkPackage` to the below:
 
   ```xml
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework> 
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework> 
   ```
 
 - **C# Single-project MSIX app doesn't compile if C++ UWP Tools aren't installed.** If you have a C# Single-project MSIX project, then you'll need to install the **C++ (v14x) Universal Windows Platform Tools** optional component.
diff --git a/hub/apps/windows-app-sdk/single-project-msix.md b/hub/apps/windows-app-sdk/single-project-msix.md
@@ -83,7 +83,7 @@ Next, edit some configuration settings to use the single-project MSIX feature. T
     <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
         <OutputType>WinExe</OutputType>
-        <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+        <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
         ...
         <UseWinUI>true</UseWinUI>
         <EnableMsixTooling>true</EnableMsixTooling>
diff --git a/hub/apps/windows-app-sdk/tutorial-unpackaged-deployment.md b/hub/apps/windows-app-sdk/tutorial-unpackaged-deployment.md
@@ -44,7 +44,7 @@ Follow these instructions to configure a C# WinUI 3 project that's either packag
     1. Replace the value of the **TargetFramework** element with a [Target Framework Moniker](../desktop/modernize/desktop-to-uwp-enhance.md#net-6-and-later-use-the-target-framework-moniker-option). For example, use the following if your app targets Windows 10, version 2004.
 
     ```xml
-    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
+    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
     ```
 
     1. Save and close the project file.
