Merge main into live

.github/ISSUE_TEMPLATE/new-feature-csharp.yml

@@ -15,9 +15,11 @@ body:
       label: Visual Studio release
       description: What Visual Studio (preview) contains this feature?
       options:
-        - 17.6p1
-        - 17.6p2
-        - 17.6p3
+        - "17.6"
+        - 17.7p1
+        - 17.7p2
+        - 17.7p3
+        - 17.7p4s
         - Other (please put exact version in description textbox)
     validations:
       required: true

docs/azure/includes/dotnet-new.md

@@ -201,7 +201,7 @@
 | Resource Management - Managed Services | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServices/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServices/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagedServices-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServices_1.0.1/sdk/managedservices/Azure.ResourceManager.ManagedServices/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServices_1.1.0-beta.1/sdk/managedservices/Azure.ResourceManager.ManagedServices/) |
 | Resource Management - Managednetworkfabric | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ManagedNetworkFabric/1.0.0-beta.1) |  | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedNetworkFabric_1.0.0-beta.1/sdk/managednetworkfabric/Azure.ResourceManager.ManagedNetworkFabric/) |
 | Resource Management - Management Partner | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.ManagementPartner/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagementPartner-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagementPartner_1.0.0-beta.3/sdk/managementpartner/Azure.ResourceManager.ManagementPartner/) |
-| Resource Management - Maps | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Maps-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.0.1/sdk/maps/Azure.ResourceManager.Maps/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.1.0-beta.1/sdk/maps/Azure.ResourceManager.Maps/) |
+| Resource Management - Maps | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.0.1)<br>NuGet [1.1.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.1.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Maps-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.0.1/sdk/maps/Azure.ResourceManager.Maps/)<br>GitHub [1.1.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.1.0-beta.2/sdk/maps/Azure.ResourceManager.Maps/) |
 | Resource Management - Marketplace | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Marketplace/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Marketplace/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Marketplace-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Marketplace_1.0.1/sdk/marketplace/Azure.ResourceManager.Marketplace/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Marketplace_1.1.0-beta.1/sdk/marketplace/Azure.ResourceManager.Marketplace/) |
 | Resource Management - Marketplace Ordering | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.MarketplaceOrdering/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.MarketplaceOrdering/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.MarketplaceOrdering-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MarketplaceOrdering_1.0.1/sdk/marketplaceordering/Azure.ResourceManager.MarketplaceOrdering/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MarketplaceOrdering_1.1.0-beta.1/sdk/marketplaceordering/Azure.ResourceManager.MarketplaceOrdering/) |
 | Resource Management - Media | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Media/1.2.0)<br>NuGet [1.3.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Media/1.3.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Media-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Media_1.2.0/sdk/mediaservices/Azure.ResourceManager.Media/)<br>GitHub [1.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Media_1.3.0-beta.1/sdk/mediaservices/Azure.ResourceManager.Media/) |
@@ -210,9 +210,9 @@
 | Resource Management - Monitor | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Monitor/1.2.0)<br>NuGet [1.3.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Monitor/1.3.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Monitor-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Monitor_1.2.0/sdk/monitor/Azure.ResourceManager.Monitor/)<br>GitHub [1.3.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Monitor_1.3.0-beta.2/sdk/monitor/Azure.ResourceManager.Monitor/) |
 | Resource Management - MySQL | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.MySql/1.0.1)<br>NuGet [1.1.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.MySql/1.1.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.MySql-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.0.1/sdk/mysql/Azure.ResourceManager.MySql/)<br>GitHub [1.1.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.1.0-beta.2/sdk/mysql/Azure.ResourceManager.MySql/) |
 | Resource Management - NetApp Files | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.NetApp/1.1.0)<br>NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.NetApp/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.NetApp-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetApp_1.1.0/sdk/netapp/Azure.ResourceManager.NetApp/)<br>GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetApp_1.2.0-beta.1/sdk/netapp/Azure.ResourceManager.NetApp/) |
-| Resource Management - Network | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.2.0)<br>NuGet [1.3.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.3.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Network-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.2.0/sdk/network/Azure.ResourceManager.Network/)<br>GitHub [1.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.3.0-beta.1/sdk/network/Azure.ResourceManager.Network/) |
+| Resource Management - Network | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Network-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.3.0/sdk/network/Azure.ResourceManager.Network/) |
 | Resource Management - Network Function | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.NetworkFunction/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkFunction-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkFunction_1.0.0-beta.3/sdk/networkfunction/Azure.ResourceManager.NetworkFunction/) |
-| Resource Management - Networkcloud | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.NetworkCloud/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkCloud-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkCloud_1.0.0-beta.1/sdk/networkcloud/Azure.ResourceManager.NetworkCloud/) |
+| Resource Management - Networkcloud | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.NetworkCloud/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkCloud-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkCloud_1.0.0-beta.2/sdk/networkcloud/Azure.ResourceManager.NetworkCloud/) |
 | Resource Management - New Relic Observability | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.NewRelicObservability/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.NewRelicObservability-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NewRelicObservability_1.0.0/sdk/newrelicobservability/Azure.ResourceManager.NewRelicObservability/) |
 | Resource Management - Nginx | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Nginx/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Nginx-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Nginx_1.0.0-beta.2/sdk/nginx/Azure.ResourceManager.Nginx/) |
 | Resource Management - Notification Hubs | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.NotificationHubs/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.NotificationHubs/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.NotificationHubs-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NotificationHubs_1.0.1/sdk/notificationhubs/Azure.ResourceManager.NotificationHubs/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NotificationHubs_1.1.0-beta.1/sdk/notificationhubs/Azure.ResourceManager.NotificationHubs/) |
@@ -260,7 +260,7 @@
 | Resource Management - Subscriptions | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Subscription/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Subscription/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Subscription-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Subscription_1.0.1/sdk/subscription/Azure.ResourceManager.Subscription/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Subscription_1.1.0-beta.1/sdk/subscription/Azure.ResourceManager.Subscription/) |
 | Resource Management - Support | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Support/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Support/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Support-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Support_1.0.1/sdk/support/Azure.ResourceManager.Support/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Support_1.1.0-beta.1/sdk/support/Azure.ResourceManager.Support/) |
 | Resource Management - Synapse | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Synapse/1.1.1)<br>NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Synapse/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Synapse-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Synapse_1.1.1/sdk/synapse/Azure.ResourceManager.Synapse/)<br>GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Synapse_1.2.0-beta.1/sdk/synapse/Azure.ResourceManager.Synapse/) |
-| Resource Management - Traffic Manager | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.TrafficManager/1.0.0)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.TrafficManager/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.TrafficManager-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.TrafficManager_1.0.0/sdk/trafficmanager/Azure.ResourceManager.TrafficManager/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.TrafficManager_1.1.0-beta.3/sdk/trafficmanager/Azure.ResourceManager.TrafficManager/) |
+| Resource Management - Traffic Manager | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.TrafficManager/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.TrafficManager-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.TrafficManager_1.1.0/sdk/trafficmanager/Azure.ResourceManager.TrafficManager/) |
 | Resource Management - Voice Services | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.VoiceServices/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.VoiceServices-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.VoiceServices_1.0.0/sdk/voiceservices/Azure.ResourceManager.VoiceServices/) |
 | Resource Management - Web PubSub | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.WebPubSub/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.WebPubSub/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.WebPubSub-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.WebPubSub_1.0.1/sdk/webpubsub/Azure.ResourceManager.WebPubSub/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.WebPubSub_1.1.0-beta.1/sdk/webpubsub/Azure.ResourceManager.WebPubSub/) |
 | Resource Management - Workload Monitor | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.WorkloadMonitor/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.WorkloadMonitor-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.WorkloadMonitor_1.0.0-beta.3/sdk/workloadmonitor/Azure.ResourceManager.WorkloadMonitor/) |

docs/core/deploying/single-file/overview.md

@@ -13,6 +13,9 @@ Bundling all application-dependent files into a single binary provides an applic
 
 The size of the single file in a self-contained application is large since it includes the runtime and the framework libraries. In .NET 6, you can [publish trimmed](../trimming/trim-self-contained.md) to reduce the total size of trim-compatible applications. The single file deployment option can be combined with [ReadyToRun](../ready-to-run.md) and [Trim](../trimming/trim-self-contained.md) publish options.
 
+> [IMPORTANT]
+> To run a single file app on Windows 7, you must use .NET Runtime 6.0.3 or later.
+
 ## Sample project file
 
 Here's a sample project file that specifies single file publishing:

docs/core/install/linux-scripted-manual.md

@@ -87,7 +87,7 @@ wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
 Before running this script, you'll need to grant permission for this script to run as an executable:
 
 ```bash
-sudo chmod +x ./dotnet-install.sh
+chmod +x ./dotnet-install.sh
 ```
 
 The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) SDK version, which is .NET 6. To install the latest release, which may not be an (LTS) version, use the `--version latest` parameter.
@@ -168,7 +168,7 @@ Set the following two environment variables in your shell profile:
   This variable should include both the `DOTNET_ROOT` folder and the user's _.dotnet/tools_ folder:
 
   ```bash
-  export PATH=$PATH:$HOME/.dotnet:$HOME/.dotnet/tools
+  export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
   ```
 
 ## Next steps

docs/core/install/linux-ubuntu.md

@@ -11,7 +11,7 @@ ms.date: 05/24/2023
 This article describes how to install .NET on Ubuntu. The Microsoft package repository contains every version of .NET that is currently, or was previously, supported on Ubuntu. Starting with Ubuntu 22.04, some versions of .NET are available in the Ubuntu package feed. For more information about available versions, see the [Supported distributions](#supported-distributions) section.
 
 > [!WARNING]
-> It's recommended that you avoid using both the Microsoft and Ubuntu package repositories for .NET, as this leads to problems when apps try to resolve a specific version of .NET.
+> It's recommended that you choose a single repository to source .NET packages. Don't mix .NET packages from multiple package repositories, as this leads to problems when apps try to resolve a specific version of .NET.
 
 | Method | Pros | Cons |
 |--------|------|------|

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

@@ -539,12 +539,12 @@ If you specify this property but you set [GenerateDocumentationFile](#generatedo
 
 ### EmbeddedResourceUseDependentUponConvention
 
-The `EmbeddedResourceUseDependentUponConvention` property defines whether resource manifest file names are generated from type information in source files that are co-located with resource files. For example, if *Form1.resx* is in the same folder as *Form1.cs*, and `EmbeddedResourceUseDependentUponConvention` is set to `true`, the generated *.resources* file takes its name from the first type that's defined in *Form1.cs*. For example, if `MyNamespace.Form1` is the first type defined in *Form1.cs*, the generated file name is *MyNamespace.Form1.resources*.
+The `EmbeddedResourceUseDependentUponConvention` property defines whether resource manifest file names are generated from type information in source files that are co-located with resource files. For example, if *Form1.resx* is in the same folder as *Form1.cs*, and `EmbeddedResourceUseDependentUponConvention` is set to `true`, the generated *.resources* file takes its name from the first type that's defined in *Form1.cs*. If `MyNamespace.Form1` is the first type defined in *Form1.cs*, the generated file name is *MyNamespace.Form1.resources*.
 
 > [!NOTE]
 > If `LogicalName`, `ManifestResourceName`, or `DependentUpon` metadata is specified for an `EmbeddedResource` item, the generated manifest file name for that resource file is based on that metadata instead.
 
-By default, in a new .NET project, this property is set to `true`. If set to `false`, and no `LogicalName`, `ManifestResourceName`, or `DependentUpon` metadata is specified for the `EmbeddedResource` item in the project file, the resource manifest file name is based off the root namespace for the project and the relative file path to the *.resx* file. For more information, see [How resource manifest files are named](../resources/manifest-file-names.md).
+By default, in a new .NET project that targets .NET Core 3.0 or a later version, this property is set to `true`. If set to `false`, and no `LogicalName`, `ManifestResourceName`, or `DependentUpon` metadata is specified for the `EmbeddedResource` item in the project file, the resource manifest file name is based off the root namespace for the project and the relative file path to the *.resx* file. For more information, see [How resource manifest files are named](../resources/manifest-file-names.md).
 
 ```xml
 <PropertyGroup>