diff --git a/docs/ai/quickstarts/includes/troubleshoot.md b/docs/ai/quickstarts/includes/troubleshoot.md deleted file mode 100644 index e0c2f7c0119ec..0000000000000 --- a/docs/ai/quickstarts/includes/troubleshoot.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -author: jmatthiesen -ms.author: jomatthi -ms.date: 07/03/2024 -ms.topic: include ---- - -## Troubleshoot - -On Windows, you might get the following error messages after running `azd up`: - -> *postprovision.ps1 is not digitally signed. The script will not execute on the system* - -The script **postprovision.ps1** is executed to set the .NET user secrets used in the application. To avoid this error, run the following PowerShell command: - -```powershell -Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -``` - -Then re-run the `azd up` command. - -Another possible error: - -> 'pwsh' is not recognized as an internal or external command, -> operable program or batch file. -> WARNING: 'postprovision' hook failed with exit code: '1', Path: '.\infra\post-script\postprovision.ps1'. : exit code: 1 -> Execution will continue since ContinueOnError has been set to true. - -The script **postprovision.ps1** is executed to set the .NET user secrets used in the application. To avoid this error, manually run the script using the following PowerShell command: - -```powershell -.\infra\post-script\postprovision.ps1 -``` - -The .NET AI apps now have the user secrets configured and they can be tested. diff --git a/docs/architecture/cloud-native/infrastructure-resiliency-azure.md b/docs/architecture/cloud-native/infrastructure-resiliency-azure.md index 983e524ed57cd..71adb7a11543b 100644 --- a/docs/architecture/cloud-native/infrastructure-resiliency-azure.md +++ b/docs/architecture/cloud-native/infrastructure-resiliency-azure.md @@ -85,7 +85,7 @@ The cloud thrives on scaling. The ability to increase/decrease system resources We encouraged the best practice of implementing programmatic retry operations in an earlier section. Keep in mind that many Azure services and their corresponding client SDKs also include retry mechanisms. The following list summarizes retry features in the many of the Azure services that are discussed in this book: -- *Azure Cosmos DB.* The class from the client API automatically retires failed attempts. The number of retries and maximum wait time are configurable. Exceptions thrown by the client API are either requests that exceed the retry policy or non-transient errors. +- *Azure Cosmos DB.* The class from the client API automatically retries failed attempts. The number of retries and maximum wait time are configurable. Exceptions thrown by the client API are either requests that exceed the retry policy or non-transient errors. - *Azure Redis Cache.* The Redis StackExchange client uses a connection manager class that includes retries on failed attempts. The number of retries, specific retry policy and wait time are all configurable. diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 42cef37d6c311..4789c67b20b05 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -187,7 +187,7 @@ | Resource Management - Chaos | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Chaos-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.0.0/sdk/chaos/Azure.ResourceManager.Chaos/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.1.0-beta.1/sdk/chaos/Azure.ResourceManager.Chaos/) | | Resource Management - Cognitive Services | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.CognitiveServices/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.CognitiveServices-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CognitiveServices_1.4.0/sdk/cognitiveservices/Azure.ResourceManager.CognitiveServices/) | | Resource Management - Communication | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Communication/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Communication-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Communication_1.2.0/sdk/communication/Azure.ResourceManager.Communication/) | -| Resource Management - Compute | NuGet [1.6.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.6.0)
NuGet [1.7.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.7.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.6.0/sdk/compute/Azure.ResourceManager.Compute/)
GitHub [1.7.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.7.0-beta.2/sdk/compute/Azure.ResourceManager.Compute/) | +| Resource Management - Compute | NuGet [1.7.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.7.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.7.0/sdk/compute/Azure.ResourceManager.Compute/) | | Resource Management - Computefleet | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeFleet/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeFleet-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeFleet_1.0.0/sdk/computefleet/Azure.ResourceManager.ComputeFleet/) | | Resource Management - Computeschedule | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ComputeSchedule/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeSchedule-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.ComputeSchedule_1.0.0-beta.1/sdk/computeschedule/Azure.ResourceManager.ComputeSchedule/) | | Resource Management - Confidential Ledger | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.0.1)
NuGet [1.1.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.1.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.ConfidentialLedger-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.0.1/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/)
GitHub [1.1.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.1.0-beta.4/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/) | @@ -201,7 +201,7 @@ | Resource Management - Container Service Fleet | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ContainerServiceFleet/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerServiceFleet/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerServiceFleet-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerServiceFleet_1.0.0/sdk/fleet/Azure.ResourceManager.ContainerServiceFleet/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerServiceFleet_1.1.0-beta.1/sdk/fleet/Azure.ResourceManager.ContainerServiceFleet/) | | Resource Management - Containerorchestratorruntime | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerOrchestratorRuntime/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerOrchestratorRuntime-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.ContainerOrchestratorRuntime_1.0.0-beta.1/sdk/containerorchestratorruntime/Azure.ResourceManager.ContainerOrchestratorRuntime/) | | Resource Management - Content Delivery Network | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Cdn/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Cdn-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Cdn_1.3.0/sdk/cdn/Azure.ResourceManager.Cdn/) | -| Resource Management - Cosmos DB | NuGet [1.3.2](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.3.2)
NuGet [1.4.0-beta.11](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.4.0-beta.11) | [docs](/dotnet/api/overview/azure/ResourceManager.CosmosDB-readme) | GitHub [1.3.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.3.2/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/)
GitHub [1.4.0-beta.11](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.4.0-beta.11/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/) | +| Resource Management - Cosmos DB | NuGet [1.3.2](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.3.2)
NuGet [1.4.0-beta.12](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.4.0-beta.12) | [docs](/dotnet/api/overview/azure/ResourceManager.CosmosDB-readme) | GitHub [1.3.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.3.2/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/)
GitHub [1.4.0-beta.12](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.4.0-beta.12/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/) | | Resource Management - Cosmos DB for PostgreSQL | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDBForPostgreSql/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDBForPostgreSql/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CosmosDBForPostgreSql-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDBForPostgreSql_1.0.0/sdk/cosmosdbforpostgresql/Azure.ResourceManager.CosmosDBForPostgreSql/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDBForPostgreSql_1.1.0-beta.1/sdk/cosmosdbforpostgresql/Azure.ResourceManager.CosmosDBForPostgreSql/) | | Resource Management - Costmanagement | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.CostManagement/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CostManagement-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CostManagement_1.0.1/sdk/costmanagement/Azure.ResourceManager.CostManagement/) | | Resource Management - Customer Insights | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.CustomerInsights/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.CustomerInsights-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CustomerInsights_1.0.0-beta.4/sdk/customer-insights/Azure.ResourceManager.CustomerInsights/) | @@ -224,14 +224,14 @@ | Resource Management - Device Registry | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DeviceRegistry/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DeviceRegistry-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.DeviceRegistry_1.0.0-beta.1/sdk/deviceregistry/Azure.ResourceManager.DeviceRegistry/) | | Resource Management - Device Update | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.DeviceUpdate/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DeviceUpdate-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DeviceUpdate_1.0.0/sdk/deviceupdate/Azure.ResourceManager.DeviceUpdate/) | | Resource Management - DevOps Infrastructure | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DevOpsInfrastructure/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevOpsInfrastructure-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.DevOpsInfrastructure_1.0.0-beta.1/sdk/devopsinfrastructure/Azure.ResourceManager.DevOpsInfrastructure/) | -| Resource Management - DevTest Labs | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.DevTestLabs/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DevTestLabs-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevTestLabs_1.1.0/sdk/devtestlabs/Azure.ResourceManager.DevTestLabs/) | +| Resource Management - DevTest Labs | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DevTestLabs/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevTestLabs-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevTestLabs_1.1.1/sdk/devtestlabs/Azure.ResourceManager.DevTestLabs/) | | Resource Management - Digital Twins | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DigitalTwins-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DigitalTwins_1.3.0/sdk/digitaltwins/Azure.ResourceManager.DigitalTwins/) | | Resource Management - DNS | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.1.1)
NuGet [1.2.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.2.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Dns-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.1.1/sdk/dns/Azure.ResourceManager.Dns/)
GitHub [1.2.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.2.0-beta.2/sdk/dns/Azure.ResourceManager.Dns/) | | Resource Management - DNS Resolver | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.DnsResolver/1.1.0)
NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DnsResolver/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DnsResolver-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DnsResolver_1.1.0/sdk/dnsresolver/Azure.ResourceManager.DnsResolver/)
GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DnsResolver_1.2.0-beta.1/sdk/dnsresolver/Azure.ResourceManager.DnsResolver/) | | Resource Management - Dynatrace | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Dynatrace/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Dynatrace-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dynatrace_1.1.0/sdk/dynatrace/Azure.ResourceManager.Dynatrace/) | | Resource Management - Edge Order | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.EdgeOrder/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.EdgeOrder-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EdgeOrder_1.1.0/sdk/edgeorder/Azure.ResourceManager.EdgeOrder/) | | Resource Management - Edge Zones | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.EdgeZones/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.EdgeZones-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.EdgeZones_1.0.0-beta.1/sdk/edgezones/Azure.ResourceManager.EdgeZones/) | -| Resource Management - Elastic | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.Elastic/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.Elastic-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Elastic_1.0.0-beta.5/sdk/elastic/Azure.ResourceManager.Elastic/) | +| Resource Management - Elastic | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Elastic/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Elastic-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Elastic_1.0.0/sdk/elastic/Azure.ResourceManager.Elastic/) | | Resource Management - ElasticSan | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ElasticSan/1.1.0)
NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ElasticSan/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ElasticSan-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ElasticSan_1.1.0/sdk/elasticsan/Azure.ResourceManager.ElasticSan/)
GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ElasticSan_1.2.0-beta.1/sdk/elasticsan/Azure.ResourceManager.ElasticSan/) | | Resource Management - Energy Services | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.EnergyServices/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.EnergyServices-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.EnergyServices_1.0.0-beta.2/sdk/openenergyplatform/Azure.ResourceManager.EnergyServices/) | | Resource Management - Event Grid | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.0.1)
NuGet [1.1.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.1.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.EventGrid-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.0.1/sdk/eventgrid/Azure.ResourceManager.EventGrid/)
GitHub [1.1.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.1.0-beta.5/sdk/eventgrid/Azure.ResourceManager.EventGrid/) | @@ -477,7 +477,7 @@ | App Service - API Apps Service | NuGet [0.9.64](https://www.nuget.org/packages/Microsoft.Azure.AppService.ApiApps.Service/0.9.64) | | | | Code Analyzers for Durable Functions | NuGet [0.5.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask.Analyzers/0.5.0) | | GitHub [0.5.0](https://github.com/Azure/azure-functions-durable-extension/tree/Analyzer-v0.3.0/src/WebJobs.Extensions.DurableTask.Analyzers) | | Cosmos DB - BulkExecutor | NuGet [2.5.1-preview](https://www.nuget.org/packages/Microsoft.Azure.CosmosDB.BulkExecutor/2.5.1-preview) | | GitHub [2.5.1-preview](https://github.com/Azure/azure-cosmosdb-bulkexecutor-dotnet-getting-started) | -| Cosmos DB - Direct | NuGet [3.37.4](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Direct/3.37.4) | | GitHub [3.37.4](https://github.com/Azure/azure-cosmos-dotnet-v3) | +| Cosmos DB - Direct | NuGet [3.37.5](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Direct/3.37.5) | | GitHub [3.37.5](https://github.com/Azure/azure-cosmos-dotnet-v3) | | Cosmos DB - Encryption | NuGet [2.0.3](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption/2.0.3)
NuGet [2.1.0-preview4](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption/2.1.0-preview4) | | GitHub [2.0.3](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/releases/encryption/1.0.0-preview4/Microsoft.Azure.Cosmos.Encryption) | | Cosmos DB - Encryption | NuGet [1.0.0-preview07](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption.Custom/1.0.0-preview07) | | | | Extensions - Caching Cosmos | NuGet [1.7.0](https://www.nuget.org/packages/Microsoft.Extensions.Caching.Cosmos/1.7.0) | | GitHub [1.7.0](https://github.com/Azure/Microsoft.Extensions.Caching.Cosmos/tree/v1.0.0-preview4) | @@ -525,7 +525,7 @@ | Microsoft.Azure.Functions.Worker.Extensions.Abstractions | NuGet [1.3.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Abstractions/1.3.0) | | | | Microsoft.Azure.Functions.Worker.Extensions.ApplicationInsights | NuGet [1.0.0-preview4](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.ApplicationInsights/1.0.0-preview4) | | | | Microsoft.Azure.Functions.Worker.Extensions.CosmosDB | NuGet [4.11.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.CosmosDB/4.11.0) | | | -| Microsoft.Azure.Functions.Worker.Extensions.EventGrid | NuGet [3.4.3](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventGrid/3.4.3) | | | +| Microsoft.Azure.Functions.Worker.Extensions.EventGrid | NuGet [3.4.2](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventGrid/3.4.2) | | | | Microsoft.Azure.Functions.Worker.Extensions.EventHubs | NuGet [6.3.6](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventHubs/6.3.6) | | | | Microsoft.Azure.Functions.Worker.Extensions.Http | NuGet [3.2.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Http/3.2.0) | | | | Microsoft.Azure.Functions.Worker.Extensions.Kafka | NuGet [4.0.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Kafka/4.0.0) | | | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index 28c25df8554f5..8cd89919fe562 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -193,7 +193,7 @@ | Resource Management - Chaos | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Chaos-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.0.0/sdk/chaos/Azure.ResourceManager.Chaos/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.1.0-beta.1/sdk/chaos/Azure.ResourceManager.Chaos/) | | Resource Management - Cognitive Services | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.CognitiveServices/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.CognitiveServices-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CognitiveServices_1.4.0/sdk/cognitiveservices/Azure.ResourceManager.CognitiveServices/) | | Resource Management - Communication | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Communication/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Communication-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Communication_1.2.0/sdk/communication/Azure.ResourceManager.Communication/) | -| Resource Management - Compute | NuGet [1.6.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.6.0)
NuGet [1.7.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.7.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.6.0/sdk/compute/Azure.ResourceManager.Compute/)
GitHub [1.7.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.7.0-beta.2/sdk/compute/Azure.ResourceManager.Compute/) | +| Resource Management - Compute | NuGet [1.7.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.7.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.7.0/sdk/compute/Azure.ResourceManager.Compute/) | | Resource Management - Computefleet | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeFleet/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeFleet-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeFleet_1.0.0/sdk/computefleet/Azure.ResourceManager.ComputeFleet/) | | Resource Management - Computeschedule | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ComputeSchedule/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeSchedule-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.ComputeSchedule_1.0.0-beta.1/sdk/computeschedule/Azure.ResourceManager.ComputeSchedule/) | | Resource Management - Confidential Ledger | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.0.1)
NuGet [1.1.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.1.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.ConfidentialLedger-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.0.1/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/)
GitHub [1.1.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.1.0-beta.4/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/) | @@ -207,7 +207,7 @@ | Resource Management - Container Service Fleet | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ContainerServiceFleet/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerServiceFleet/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerServiceFleet-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerServiceFleet_1.0.0/sdk/fleet/Azure.ResourceManager.ContainerServiceFleet/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerServiceFleet_1.1.0-beta.1/sdk/fleet/Azure.ResourceManager.ContainerServiceFleet/) | | Resource Management - Containerorchestratorruntime | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerOrchestratorRuntime/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerOrchestratorRuntime-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.ContainerOrchestratorRuntime_1.0.0-beta.1/sdk/containerorchestratorruntime/Azure.ResourceManager.ContainerOrchestratorRuntime/) | | Resource Management - Content Delivery Network | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Cdn/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Cdn-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Cdn_1.3.0/sdk/cdn/Azure.ResourceManager.Cdn/) | -| Resource Management - Cosmos DB | NuGet [1.3.2](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.3.2)
NuGet [1.4.0-beta.11](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.4.0-beta.11) | [docs](/dotnet/api/overview/azure/ResourceManager.CosmosDB-readme) | GitHub [1.3.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.3.2/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/)
GitHub [1.4.0-beta.11](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.4.0-beta.11/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/) | +| Resource Management - Cosmos DB | NuGet [1.3.2](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.3.2)
NuGet [1.4.0-beta.12](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDB/1.4.0-beta.12) | [docs](/dotnet/api/overview/azure/ResourceManager.CosmosDB-readme) | GitHub [1.3.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.3.2/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/)
GitHub [1.4.0-beta.12](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.4.0-beta.12/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/) | | Resource Management - Cosmos DB for PostgreSQL | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDBForPostgreSql/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CosmosDBForPostgreSql/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CosmosDBForPostgreSql-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDBForPostgreSql_1.0.0/sdk/cosmosdbforpostgresql/Azure.ResourceManager.CosmosDBForPostgreSql/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDBForPostgreSql_1.1.0-beta.1/sdk/cosmosdbforpostgresql/Azure.ResourceManager.CosmosDBForPostgreSql/) | | Resource Management - Costmanagement | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.CostManagement/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CostManagement-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CostManagement_1.0.1/sdk/costmanagement/Azure.ResourceManager.CostManagement/) | | Resource Management - Customer Insights | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.CustomerInsights/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.CustomerInsights-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CustomerInsights_1.0.0-beta.4/sdk/customer-insights/Azure.ResourceManager.CustomerInsights/) | @@ -230,14 +230,14 @@ | Resource Management - Device Registry | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DeviceRegistry/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DeviceRegistry-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.DeviceRegistry_1.0.0-beta.1/sdk/deviceregistry/Azure.ResourceManager.DeviceRegistry/) | | Resource Management - Device Update | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.DeviceUpdate/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DeviceUpdate-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DeviceUpdate_1.0.0/sdk/deviceupdate/Azure.ResourceManager.DeviceUpdate/) | | Resource Management - DevOps Infrastructure | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DevOpsInfrastructure/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevOpsInfrastructure-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.DevOpsInfrastructure_1.0.0-beta.1/sdk/devopsinfrastructure/Azure.ResourceManager.DevOpsInfrastructure/) | -| Resource Management - DevTest Labs | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.DevTestLabs/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DevTestLabs-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevTestLabs_1.1.0/sdk/devtestlabs/Azure.ResourceManager.DevTestLabs/) | +| Resource Management - DevTest Labs | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DevTestLabs/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevTestLabs-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevTestLabs_1.1.1/sdk/devtestlabs/Azure.ResourceManager.DevTestLabs/) | | Resource Management - Digital Twins | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DigitalTwins-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DigitalTwins_1.3.0/sdk/digitaltwins/Azure.ResourceManager.DigitalTwins/) | | Resource Management - DNS | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.1.1)
NuGet [1.2.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.2.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Dns-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.1.1/sdk/dns/Azure.ResourceManager.Dns/)
GitHub [1.2.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.2.0-beta.2/sdk/dns/Azure.ResourceManager.Dns/) | | Resource Management - DNS Resolver | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.DnsResolver/1.1.0)
NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DnsResolver/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DnsResolver-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DnsResolver_1.1.0/sdk/dnsresolver/Azure.ResourceManager.DnsResolver/)
GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DnsResolver_1.2.0-beta.1/sdk/dnsresolver/Azure.ResourceManager.DnsResolver/) | | Resource Management - Dynatrace | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Dynatrace/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Dynatrace-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dynatrace_1.1.0/sdk/dynatrace/Azure.ResourceManager.Dynatrace/) | | Resource Management - Edge Order | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.EdgeOrder/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.EdgeOrder-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EdgeOrder_1.1.0/sdk/edgeorder/Azure.ResourceManager.EdgeOrder/) | | Resource Management - Edge Zones | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.EdgeZones/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.EdgeZones-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.EdgeZones_1.0.0-beta.1/sdk/edgezones/Azure.ResourceManager.EdgeZones/) | -| Resource Management - Elastic | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.Elastic/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.Elastic-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Elastic_1.0.0-beta.5/sdk/elastic/Azure.ResourceManager.Elastic/) | +| Resource Management - Elastic | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Elastic/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Elastic-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Elastic_1.0.0/sdk/elastic/Azure.ResourceManager.Elastic/) | | Resource Management - ElasticSan | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ElasticSan/1.1.0)
NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ElasticSan/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ElasticSan-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ElasticSan_1.1.0/sdk/elasticsan/Azure.ResourceManager.ElasticSan/)
GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ElasticSan_1.2.0-beta.1/sdk/elasticsan/Azure.ResourceManager.ElasticSan/) | | Resource Management - Energy Services | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.EnergyServices/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.EnergyServices-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.EnergyServices_1.0.0-beta.2/sdk/openenergyplatform/Azure.ResourceManager.EnergyServices/) | | Resource Management - Event Grid | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.0.1)
NuGet [1.1.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.1.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.EventGrid-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.0.1/sdk/eventgrid/Azure.ResourceManager.EventGrid/)
GitHub [1.1.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.1.0-beta.5/sdk/eventgrid/Azure.ResourceManager.EventGrid/) | diff --git a/docs/core/compatibility/9.0.md b/docs/core/compatibility/9.0.md index 00b52cf876fa6..687fdb5e1db89 100644 --- a/docs/core/compatibility/9.0.md +++ b/docs/core/compatibility/9.0.md @@ -100,9 +100,11 @@ If you're migrating an app to .NET 9, the breaking changes listed here might aff | Title | Type of change | Introduced version | |-------------------------------------------------------------------------------|-------------------|--------------------| | [`dotnet restore` audits transitive packages](sdk/9.0/nugetaudit-transitive-packages.md) | Behavioral change | Preview 6 | +| [`dotnet sln add` doesn't allow invalid file names](sdk/9.0/dotnet-sln.md) | Behavioral change | 9.0.2xx | | [`dotnet watch` incompatible with Hot Reload for old frameworks](sdk/9.0/dotnet-watch.md) | Behavioral change | RC 1 | | [`dotnet workload` commands output change](sdk/9.0/dotnet-workload-output.md) | Behavioral change | Preview 1 | | [`installer` repo version no longer documented](sdk/9.0/productcommits-versions.md) | Behavioral change | Preview 5 | +| [New default RID used when targeting .NET Framework](sdk/9.0/default-rid.md) | Source incompatible | GA | | [Terminal logger is default](sdk/9.0/terminal-logger.md) | Behavioral change | Preview 1 | | [Version requirements for .NET 9 SDK](sdk/9.0/version-requirements.md) | Source incompatible | GA | | [Warning emitted for .NET Standard 1.x target](sdk/9.0/netstandard-warning.md) | Source incompatible | Preview 6 | diff --git a/docs/core/compatibility/sdk/9.0/default-rid.md b/docs/core/compatibility/sdk/9.0/default-rid.md new file mode 100644 index 0000000000000..1f48a42040f4a --- /dev/null +++ b/docs/core/compatibility/sdk/9.0/default-rid.md @@ -0,0 +1,65 @@ +--- +title: "Default RID used when targeting .NET Framework" +description: "Learn about the breaking change in the .NET 9 SDK where a new default RID is used for apps that target .NET Framework." +ms.date: 12/5/2024 +ai-usage: ai-assisted +ms.custom: https://github.com/dotnet/docs/issues/43692 +--- + +# Default RID used when targeting .NET Framework + +In .NET 8, a change was introduced to [use a smaller runtime identifier (RID) graph](../8.0/rid-graph.md) when targeting `net8.0` and later versions. + +However, this broke customers who multi-target .NET and .NET Framework. That's because the restore happens once, but the .NET Framework project tries to use the old RID default and the .NET (Core) project tries to use the new reduced RID graph. + +To enable this multi-targeting scenario, a default RID that's compatible with the new RID graph is now used in this scenario. + +## Version introduced + +.NET 9 GA + +## Previous behavior + +SDK-style projects that targeted .NET Framework with no RID set defaulted to `win7-x86` or `win7-x64`. + +## New behavior + +SDK-style projects that target .NET Framework with no RID set default to `win-x86` or `win-x64`. + +## Type of breaking change + +This change can affect [source compatibility](../../categories.md#source-compatibility). + +## Reason for change + +.NET Framework applications were getting a default RID that was incompatible with the portable RID graph. That incompatibility resulted in a restore error: + +> Sdks\Microsoft.NET.Sdk\targets\Microsoft.PackageDependencyResolution.targets(266,5): error NETSDK1047: Assets file 'D:\1\s\artifacts\obj\MSBuild\project.assets.json' doesn't have a target for 'net472/win7-x64'. Ensure that restore has run and that you have included 'net472' in the TargetFrameworks for your project. You may also need to include 'win7-x64' in your project's RuntimeIdentifiers. \[MSBuild.csproj::TargetFramework=net472]> + +For more information, see [dotnet/sdk issue #35575](https://github.com/dotnet/sdk/issues/35575). + +## Recommended action + +If you're affected by this change, choose one of the following actions: + +- Update your runtime identifier to a value supported by the portable RID graph. Project file example: + + ```xml + + win-x64 + + ``` + + If you specify the RID as a command-line argument, make a similar change. For example, `dotnet publish --runtime win-x64`. + +- Switch back to the old RID graph by setting `UseRidGraph` to `true` in the project file: + + ```xml + + true + + ``` + +## Affected APIs + +None. diff --git a/docs/core/compatibility/sdk/9.0/dotnet-sln.md b/docs/core/compatibility/sdk/9.0/dotnet-sln.md new file mode 100644 index 0000000000000..d2531ebf8acf7 --- /dev/null +++ b/docs/core/compatibility/sdk/9.0/dotnet-sln.md @@ -0,0 +1,47 @@ +--- +title: "'dotnet sln add' no longer allows invalid file names" +description: Learn about the breaking change in the .NET SDK where the CLI command 'dotnet sln add' adds support for .slnx solution files and no longer allows invalid file names. +ms.date: 12/10/2024 +ai-usage: ai-assisted +ms.custom: https://github.com/dotnet/docs/issues/43882 +--- + +# `dotnet sln add` no longer allows invalid file names + +Starting in .NET SDK 9.0.2xx, the [`dotnet sln add`](../../../tools/dotnet-sln.md#add) CLI command includes support for *.slnx* solution files using the [vs-solutionpersistence](https://github.com/microsoft/vs-solutionpersistence) serializer. As a result, slight changes in behavior are expected. + +## Version introduced + +.NET SDK 9.0.2xx + +## Previous behavior + +Previously, projects and solution folders could have invalid Windows file names. They could also have invalid characters in their names. In addition, `dotnet sln add` failed if you attempted to add a nested project with the same name as an existing project. + +## New behavior + +Starting in .NET SDK 9.0.2xx, projects and solution folder names: + +- Can't be a DOS word: `NUL`, `CON`, `AUX`, `PRN`, `COM?`, `LPT?`, or `CLOCK$` (where `?` is any number of digits). +- Must be 260 characters or less. +- Can't contain invalid characters, such as control characters or `?`, `:`, `\`, `/`, `*`, `"`, `"`, `<`, `>`, and `|`. + +In addition, `dotnet sln add` now succeeds if you attempt to add a nested project with the same name as an existing project, which mimics the behavior for non-nested projects. Example: Adding `folder/project.csproj` and `parent/child/project.csproj` doesn't result in an error. + +Exceptions contain the current strings, but wrap error messages from [vs-solutionpersistence](https://github.com/microsoft/vs-solutionpersistence). + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +These changes were introduced to transition to the new `vs-solutionpersistence` serializer. + +## Recommended action + +Review project and solution folders names to ensure they comply with the new naming restrictions. + +## Affected APIs + +N/A diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index 904c4d7cf4799..3d804e24526e5 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -76,6 +76,8 @@ items: items: - name: Deprecated desktop Windows/macOS/Linux MonoVM runtime packages href: deployment/9.0/monovm-packages.md + - name: Entity Framework Core + href: /ef/core/what-is-new/ef-core-9.0/breaking-changes?toc=/dotnet/core/compatibility/toc.json&bc=/dotnet/breadcrumb/toc.json - name: Interop items: - name: CET supported by default @@ -104,12 +106,16 @@ items: items: - name: "`dotnet restore` audits transitive packages" href: sdk/9.0/nugetaudit-transitive-packages.md + - name: "`dotnet sln add` doesn't allow invalid file names" + href: sdk/9.0/dotnet-sln.md - name: "`dotnet watch` incompatible with Hot Reload for old frameworks" href: sdk/9.0/dotnet-watch.md - name: "`dotnet workload` commands output change" href: sdk/9.0/dotnet-workload-output.md - name: "`installer` repo version no longer documented" href: sdk/9.0/productcommits-versions.md + - name: New default RID used when targeting .NET Framework + href: sdk/9.0/default-rid.md - name: Terminal logger is default href: sdk/9.0/terminal-logger.md - name: Version requirements @@ -1604,6 +1610,8 @@ items: href: deployment/7.0/x86-host-path.md - name: Entity Framework Core items: + - name: EF Core 9 + href: /ef/core/what-is-new/ef-core-9.0/breaking-changes?toc=/dotnet/core/compatibility/toc.json&bc=/dotnet/breadcrumb/toc.json - name: EF Core 8 href: /ef/core/what-is-new/ef-core-8.0/breaking-changes?toc=/dotnet/core/compatibility/toc.json&bc=/dotnet/breadcrumb/toc.json - name: EF Core 7 @@ -1804,12 +1812,16 @@ items: items: - name: "`dotnet restore` audits transitive packages" href: sdk/9.0/nugetaudit-transitive-packages.md + - name: "`dotnet sln add` doesn't allow invalid file names" + href: sdk/9.0/dotnet-sln.md - name: "`dotnet watch` incompatible with Hot Reload for old frameworks" href: sdk/9.0/dotnet-watch.md - name: "`dotnet workload` commands output change" href: sdk/9.0/dotnet-workload-output.md - name: "`installer` repo version no longer documented" href: sdk/9.0/productcommits-versions.md + - name: New default RID used when targeting .NET Framework + href: sdk/9.0/default-rid.md - name: Terminal logger is default href: sdk/9.0/terminal-logger.md - name: Version requirements for .NET 9 SDK diff --git a/docs/core/deploying/media/trim-self-contained/vs-build-publish.png b/docs/core/deploying/media/trim-self-contained/vs-build-publish.png new file mode 100644 index 0000000000000..52e180b5973d7 Binary files /dev/null and b/docs/core/deploying/media/trim-self-contained/vs-build-publish.png differ diff --git a/docs/core/deploying/media/trim-self-contained/vs-project-properties.png b/docs/core/deploying/media/trim-self-contained/vs-project-properties.png new file mode 100644 index 0000000000000..fb6368bb9065a Binary files /dev/null and b/docs/core/deploying/media/trim-self-contained/vs-project-properties.png differ diff --git a/docs/core/deploying/media/trim-self-contained/vs-publish-trimmed.png b/docs/core/deploying/media/trim-self-contained/vs-publish-trimmed.png new file mode 100644 index 0000000000000..8e4242710b44e Binary files /dev/null and b/docs/core/deploying/media/trim-self-contained/vs-publish-trimmed.png differ diff --git a/docs/core/deploying/trimming/trim-self-contained.md b/docs/core/deploying/trimming/trim-self-contained.md index fbe624d1974aa..2328573774638 100644 --- a/docs/core/deploying/trimming/trim-self-contained.md +++ b/docs/core/deploying/trimming/trim-self-contained.md @@ -55,27 +55,17 @@ For more information, see [Publish .NET apps with .NET CLI](../deploy-with-cli.m ### Publish with Visual Studio -01. In **Solution Explorer**, right-click on the project you want to publish and select **Publish**. +01. In **Solution Explorer**, right-click on the project you want to publish and select **Properties**. - :::image type="content" source="../media/trim-self-contained/visual-studio-solution-explorer.png" alt-text="Solution Explorer with a right-click menu highlighting the Publish option."::: + :::image type="content" source="../media/trim-self-contained/vs-project-properties.png" alt-text="Solution Explorer with a right-click menu highlighting the Properties option."::: - If you don't already have a publishing profile, follow the instructions to create one and choose the **Folder** target-type. +01. Choose **Build** > **Publish**. -01. Choose **More actions** > **Edit**. + :::image type="content" source="../media/trim-self-contained/vs-build-publish.png" alt-text="Visual studio publish page with Publish Trimmed option."::: - :::image type="content" source="../media/trim-self-contained/visual-studio-publish-edit-settings.png" alt-text="Visual studio publish profile with edit button."::: +01. Select **Publish trimmed** to publish your app trimmed. -01. In the **Profile settings** dialog, set the following options: - - - Set **Deployment mode** to **Self-contained**. - - Set **Target runtime** to the platform you want to publish to. - - Select **Trim unused code**. - - Choose **Save** to save the settings and return to the **Publish** dialog. - - :::image type="content" source="../media/trim-self-contained/visual-studio-publish-properties.png" alt-text="Profile settings dialog with deployment mode, target runtime, and trim unused assemblies options highlighted."::: - -01. Choose **Publish** to publish your app trimmed. + :::image type="content" source="../media/trim-self-contained/vs-publish-trimmed.png" alt-text="Visual studio publish page with Publish Trimmed selected."::: For more information, see [Publish .NET Core apps with Visual Studio](../deploy-with-vs.md). diff --git a/docs/core/docker/publish-as-container.md b/docs/core/docker/publish-as-container.md index 4c8845c622080..37446fc24131e 100644 --- a/docs/core/docker/publish-as-container.md +++ b/docs/core/docker/publish-as-container.md @@ -111,7 +111,7 @@ The preceding .NET CLI command publishes the app as a container: - Specifying an x64 architecture (`--arch x64`). > [!IMPORTANT] -> To build the container locally, you must have the Docker daemon running. If it isn't running when you attempt to publish the app as a container, you'll experience an error similar to the following: +> To publish the container locally, you must have the Docker daemon running. If it isn't running when you attempt to publish the app as a container, you'll experience an error similar to the following: > > ```console > ..\build\Microsoft.NET.Build.Containers.targets(66,9): error MSB4018: diff --git a/docs/core/testing/mstest-analyzers/mstest0011.md b/docs/core/testing/mstest-analyzers/mstest0011.md index 3817aae89b98f..469133b4613ed 100644 --- a/docs/core/testing/mstest-analyzers/mstest0011.md +++ b/docs/core/testing/mstest-analyzers/mstest0011.md @@ -38,7 +38,7 @@ Methods marked with `[ClassCleanup]` should follow the following layout to be va - it should not be `async void` - it should not be a special method (finalizer, operator...). - it should not be generic -- it should not take any parameter +- it should not take any parameter, or starting with MSTest 3.8, it can have a single `TestContext` parameter - return type should be `void`, `Task` or `ValueTask` - `InheritanceBehavior.BeforeEachDerivedClass` attribute parameter should be specified if the class is `abstract`. - `InheritanceBehavior.BeforeEachDerivedClass` attribute parameter should not be specified if the class is `sealed`. diff --git a/docs/core/testing/mstest-analyzers/mstest0013.md b/docs/core/testing/mstest-analyzers/mstest0013.md index ec1710378a42a..fddeb725056cc 100644 --- a/docs/core/testing/mstest-analyzers/mstest0013.md +++ b/docs/core/testing/mstest-analyzers/mstest0013.md @@ -38,7 +38,7 @@ Methods marked with `[AssemblyCleanup]` should follow the following layout to be - it should not be `async void` - it should not be a special method (finalizer, operator...). - it should not be generic -- it should not take any parameter +- it should not take any parameter, or starting with MSTest 3.8, it can have a single `TestContext` parameter - return type should be `void`, `Task` or `ValueTask` The type declaring these methods should also respect the following rules: diff --git a/docs/core/testing/unit-testing-mstest-writing-tests-attributes.md b/docs/core/testing/unit-testing-mstest-writing-tests-attributes.md index ee4e0dd7eeb31..35f1e562d2713 100644 --- a/docs/core/testing/unit-testing-mstest-writing-tests-attributes.md +++ b/docs/core/testing/unit-testing-mstest-writing-tests-attributes.md @@ -189,7 +189,7 @@ Setup and cleanup that is common to multiple tests can be extracted to a separat [AssemblyInitialize]() is called right after your assembly is loaded and [AssemblyCleanup]() is called right before your assembly is unloaded. -The methods marked with these attributes should be defined as `static void`, `static Task` or `static ValueTask` (starting with MSTest v3.3), in a `TestClass`, and appear only once. The initialize part requires one argument of type [TestContext](xref:Microsoft.VisualStudio.TestTools.UnitTesting.TestContext) and the cleanup no argument. +The methods marked with these attributes should be defined as `static void`, `static Task` or `static ValueTask` (starting with MSTest v3.3), in a `TestClass`, and appear only once. The initialize part requires one parameter of type [TestContext](xref:Microsoft.VisualStudio.TestTools.UnitTesting.TestContext) and the cleanup either no parameters, or starting with MSTest 3.8 can have one parameter of type [TestContext](xref:Microsoft.VisualStudio.TestTools.UnitTesting.TestContext). ```csharp [TestClass] @@ -201,7 +201,7 @@ public class MyTestClass } [AssemblyCleanup] - public static void AssemblyCleanup() + public static void AssemblyCleanup() // Starting with MSTest 3.8, it can be AssemblyCleanup(TestContext testContext) { } } @@ -217,7 +217,7 @@ public class MyOtherTestClass } [AssemblyCleanup] - public static async Task AssemblyCleanup() + public static async Task AssemblyCleanup() // Starting with MSTest 3.8, it can be AssemblyCleanup(TestContext testContext) { } } @@ -231,7 +231,7 @@ It's possible to control the inheritance behavior: only for current class using It's also possible to configure whether the class cleanup should be run at the end of the class or at the end of the assembly. -The methods marked with these attributes should be defined as `static void`, `static Task` or `static ValueTask` (starting with MSTest v3.3), in a `TestClass`, and appear only once. The initialize part requires one argument of type [TestContext](xref:Microsoft.VisualStudio.TestTools.UnitTesting.TestContext) and the cleanup no argument. +The methods marked with these attributes should be defined as `static void`, `static Task` or `static ValueTask` (starting with MSTest v3.3), in a `TestClass`, and appear only once. The initialize part requires one parameter of type [TestContext](xref:Microsoft.VisualStudio.TestTools.UnitTesting.TestContext) and the cleanup either no parameters, or starting with MSTest 3.8 can have one parameter of type [TestContext](xref:Microsoft.VisualStudio.TestTools.UnitTesting.TestContext). ```csharp [TestClass] @@ -243,7 +243,7 @@ public class MyTestClass } [ClassCleanup] - public static void ClassCleanup() + public static void ClassCleanup() // Starting with MSTest 3.8, it can be ClassCleanup(TestContext testContext) { } } @@ -259,7 +259,7 @@ public class MyOtherTestClass } [ClassCleanup] - public static async Task ClassCleanup() + public static async Task ClassCleanup() // Starting with MSTest 3.8, it can be ClassCleanup(TestContext testContext) { } } diff --git a/docs/csharp/advanced-topics/performance/interpolated-string-handler.md b/docs/csharp/advanced-topics/performance/interpolated-string-handler.md index 8999715a0a752..c22011733a4e5 100644 --- a/docs/csharp/advanced-topics/performance/interpolated-string-handler.md +++ b/docs/csharp/advanced-topics/performance/interpolated-string-handler.md @@ -93,7 +93,7 @@ Finally, notice that the last warning doesn't invoke the interpolated string han > [!IMPORTANT] > -> The version of the `Logger` for this section is a `ref struct`. A `ref struct` minimizes allocations because it must be stored on the stack. However, `ref struct` types, in general, can't implement interfaces. This can cause compatibility issues for unit test frameworks and mocking types that use `ref struct` types for implementation. +> Use `ref struct` for interpolated string handlers only if absolutely necessary. Using `ref struct` will have limitations as they must be stored on the stack. For example, they will not work if an interpolated string hole contains an `await` expression because the compiler will need to store the handler in the compiler-generated `IAsyncStateMachine` implementation. ## Add more capabilities to the handler diff --git a/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/Logger-v2.cs b/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/Logger-v2.cs index bed87163812ab..5a7d6bff93d28 100644 --- a/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/Logger-v2.cs +++ b/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/Logger-v2.cs @@ -5,7 +5,7 @@ namespace interpolated_string_handler.Version2 { // [InterpolatedStringHandler] - public ref struct LogInterpolatedStringHandler + public struct LogInterpolatedStringHandler { // Storage for the built-up string StringBuilder builder; diff --git a/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v3.cs b/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v3.cs index 5f76a60fce481..c94ee7140d014 100644 --- a/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v3.cs +++ b/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v3.cs @@ -4,7 +4,7 @@ namespace interpolated_string_handler.Version3 { [InterpolatedStringHandler] - public ref struct LogInterpolatedStringHandler + public struct LogInterpolatedStringHandler { // Storage for the built-up string StringBuilder builder; diff --git a/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v4.cs b/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v4.cs index 08b75c9005297..8407ca0542ba1 100644 --- a/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v4.cs +++ b/docs/csharp/advanced-topics/performance/snippets/interpolated-string-handler/logger-v4.cs @@ -4,7 +4,7 @@ namespace interpolated_string_handler.Version4 { [InterpolatedStringHandler] - public ref struct LogInterpolatedStringHandler + public struct LogInterpolatedStringHandler { // Storage for the built-up string StringBuilder builder; diff --git a/docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers.md b/docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers.md index 5ac7cac4d6595..a36d6f32e4644 100644 --- a/docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers.md +++ b/docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers.md @@ -149,6 +149,14 @@ You can specify [null](../../language-reference/keywords/null.md) as an element :::code language="csharp" source="./snippets/object-collection-initializers/BasicObjectInitializers.cs" id="ListInitializerWithNull"::: +You can use a spread element to create one list that copies other list or lists. + +:::code language="csharp" source="./snippets/object-collection-initializers/BasicObjectInitializers.cs" id="ListInitializerWithSpreadOperator"::: + +And include additonal elements along with using a spread element. + +:::code language="csharp" source="./snippets/object-collection-initializers/BasicObjectInitializers.cs" id="ListInitializerWithSpreadOperatorAndAdditionalElement"::: + You can specify indexed elements if the collection supports read / write indexing. :::code language="csharp" source="./snippets/object-collection-initializers/BasicObjectInitializers.cs" id="DictionaryIndexerInitializer"::: diff --git a/docs/csharp/programming-guide/classes-and-structs/snippets/object-collection-initializers/BasicObjectInitializers.cs b/docs/csharp/programming-guide/classes-and-structs/snippets/object-collection-initializers/BasicObjectInitializers.cs index cabbd0000b732..51b5b2f63701c 100644 --- a/docs/csharp/programming-guide/classes-and-structs/snippets/object-collection-initializers/BasicObjectInitializers.cs +++ b/docs/csharp/programming-guide/classes-and-structs/snippets/object-collection-initializers/BasicObjectInitializers.cs @@ -98,6 +98,14 @@ from p in products }; // + // + List allCats = [.. cats, .. moreCats]; + // + + // + List additionalCats = [.. cats, new Cat { Name = "Furrytail", Age = 5 }, .. moreCats]; + // + // var numbers = new Dictionary { @@ -182,15 +190,10 @@ public static void Main() null }; - // Display results. - System.Console.WriteLine(cat.Name); + List allCats = [.. cats, new Cat { Name = "Łapka", Age = 5 }, cat, .. moreCats]; - foreach (Cat c in cats) - { - System.Console.WriteLine(c.Name); - } - - foreach (Cat? c in moreCats) + // Display results. + foreach (Cat? c in allCats) { if (c != null) { @@ -203,13 +206,14 @@ public static void Main() } } // Output: - //Fluffy - //Sylvester - //Whiskers - //Sasha - //Furrytail - //Peaches - //List element has null value. + // Sylvester + // Whiskers + // Sasha + // Łapka + // Fluffy + // Furrytail + // Peaches + // List element has null value. } // diff --git a/docs/devops/github-actions-overview.md b/docs/devops/github-actions-overview.md index cf238f1ee0323..1466a30f547a5 100644 --- a/docs/devops/github-actions-overview.md +++ b/docs/devops/github-actions-overview.md @@ -185,7 +185,7 @@ For more information, see [Events that trigger workflows](https://docs.github.co The .NET command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET applications. The .NET CLI is used to `run` as part of individual `steps` within a workflow file. Common command include: -- [dotnet workflow install](../core/tools/dotnet-workload-install.md) +- [dotnet workload install](../core/tools/dotnet-workload-install.md) - [dotnet restore](../core/tools/dotnet-restore.md) - [dotnet build](../core/tools/dotnet-build.md) - [dotnet test](../core/tools/dotnet-test.md) diff --git a/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md b/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md index 57840cc0603d7..eb17b486d9d63 100644 --- a/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md +++ b/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Suspended Instance Management" title: "Suspended Instance Management" +description: "Learn more about: Suspended Instance Management" ms.date: "03/30/2017" -ms.assetid: f5ca3faa-ba1f-4857-b92c-d927e4b29598 --- # Suspended Instance Management @@ -58,7 +57,7 @@ The [SuspendedInstanceManagement sample](https://github.com/dotnet/samples/tree/ 1. In Visual Studio, run the SampleWorkflowApp project again without debugging by pressing Ctrl+F5. Two endpoint addresses will be printed in the console window: one for the application endpoint and then other from the . A workflow instance is then created, and tracking records for that instance will appear in the console window. The workflow instance will throw an exception causing the instance to be suspended and aborted. - 2. The command-line utility can then be used to take further action on any of these instances. The syntax for command line arguments is as follows:: + 2. The command-line utility can then be used to take further action on any of these instances. The syntax for command line arguments is as follows: `SuspendedInstanceManagement -Command:[CommandName] -Server:[ServerName] -Database:[DatabaseName] -InstanceId:[InstanceId]` diff --git a/docs/fsharp/tour.md b/docs/fsharp/tour.md index cc546007b46df..a831398301397 100644 --- a/docs/fsharp/tour.md +++ b/docs/fsharp/tour.md @@ -120,7 +120,7 @@ Because DUs allow you to represent the recursive structure of the tree in the da [!code-fsharp[PatternMatching](~/samples/snippets/fsharp/tour.fs#L717-L743)] -Something you may have noticed is the use of the `_` pattern. This is known as the [Wildcard Pattern](language-reference/pattern-matching.md#wildcard-pattern), which is a way of saying "I don't care what something is". Although convenient, you can accidentally bypass Exhaustive Pattern Matching and no longer benefit from compile-time enforcements if you aren't careful in using `_`. It is best used when you don't care about certain pieces of a decomposed type when pattern matching, or the final clause when you have enumerated all meaningful cases in a pattern matching expression. +The following sample introduces the `_` pattern, which you might have noticed before. This is known as the [Wildcard Pattern](language-reference/pattern-matching.md#wildcard-pattern), which is a way of saying "I don't care what something is". Although convenient, you can accidentally bypass Exhaustive Pattern Matching and no longer benefit from compile-time enforcements if you aren't careful in using `_`. It is best used when you don't care about certain pieces of a decomposed type when pattern matching, or the final clause when you have enumerated all meaningful cases in a pattern matching expression. In the following example, the `_` case is used when a parse operation fails. diff --git a/docs/standard/linq/find-element-specific-attribute.md b/docs/standard/linq/find-element-specific-attribute.md index 837b0f6a3fe77..a53a9e1a53dbe 100644 --- a/docs/standard/linq/find-element-specific-attribute.md +++ b/docs/standard/linq/find-element-specific-attribute.md @@ -84,7 +84,7 @@ Module Module1 End Module ``` -This example produces the following output:: +This example produces the following output: ```xml diff --git a/docs/standard/linq/valid-content-xelement-xdocument-objects.md b/docs/standard/linq/valid-content-xelement-xdocument-objects.md index cdea03f9b699d..8fd3eb4c9f6b3 100644 --- a/docs/standard/linq/valid-content-xelement-xdocument-objects.md +++ b/docs/standard/linq/valid-content-xelement-xdocument-objects.md @@ -2,7 +2,6 @@ title: Valid content of XElement and XDocument objects - LINQ to XML description: The XElement and XDocument constructors accept many argument types, including collections returned from queries. There are other constructors and functions for adding XML content. ms.date: 07/20/2015 -ms.assetid: 0d253586-2b97-459f-b1a7-f30f38f3ed9f --- # Valid content of XElement and XDocument objects (LINQ to XML) @@ -13,7 +12,7 @@ This article describes the valid arguments that can be passed to constructors, a Queries often evaluate to of or of . You can pass collections of or objects to the constructor. That's why it's convenient to pass the results of a query as content into methods and constructors that you use to populate XML trees. -When adding simple content, various types can be passed to this method, including:: +When adding simple content, various types can be passed to this method, including: - - diff --git a/docs/visual-basic/language-reference/data-types/decimal-data-type.md b/docs/visual-basic/language-reference/data-types/decimal-data-type.md index a0efadd505fcc..58c46b0a9f224 100644 --- a/docs/visual-basic/language-reference/data-types/decimal-data-type.md +++ b/docs/visual-basic/language-reference/data-types/decimal-data-type.md @@ -38,7 +38,22 @@ The default value of `Decimal` is 0. - **Performance.** The `Decimal` data type is the slowest of all the numeric types. You should weigh the importance of precision against performance before choosing a data type. -- **Widening.** The `Decimal` data type widens to `Single` or `Double`. This means you can convert `Decimal` to either of these types without encountering a error. +- **Widening.** The `Decimal` data type can be converted to `Single` or `Double` without encountering a error. However, this conversion may result in **loss of precision**, as `Single` and `Double` prioritize accommodating larger values over preserving precision. + +```vb +Dim decimalValue As Decimal = 1234567890123456789012345D +Dim doubleValue As Double = CDbl(decimalValue) + +Console.WriteLine("Decimal value: " & decimalValue) +Console.WriteLine("Double value: " & doubleValue) +``` + +The output of the preceding example shows that the **Decimal value** retains full precision, while the **Double value** loses precision due to the limitations of the `Double` data type. + +```console + Decimal value: 1234567890123456789012345 + Double value: 1.23456789012346E+24 +``` - **Trailing Zeros.** Visual Basic does not store trailing zeros in a `Decimal` literal. However, a `Decimal` variable preserves any trailing zeros acquired computationally. The following example illustrates this. diff --git a/docs/whats-new/dotnet-docs-mod0.md b/docs/whats-new/dotnet-docs-mod0.md index eea33f34b2c54..9e23817330c66 100644 --- a/docs/whats-new/dotnet-docs-mod0.md +++ b/docs/whats-new/dotnet-docs-mod0.md @@ -1,88 +1,90 @@ --- -title: ".NET docs: What's new for September 2024" -description: "What's new in the .NET docs for September 2024." -ms.custom: September-2024 -ms.date: 10/01/2024 +title: ".NET docs: What's new for December 2024" +description: "What's new in the .NET docs for December 2024." +ms.custom: December-2024 +ms.date: 01/01/2025 --- -# .NET docs: What's new for September 2024 +# .NET docs: What's new for December 2024 -Welcome to what's new in the .NET docs for September 2024. This article lists some of the major changes to docs during this period. +Welcome to what's new in the .NET docs for December 2024. This article lists some of the major changes to docs during this period. ## .NET breaking changes ### New articles -- [Floating point-to-integer conversions are saturating](../core/compatibility/jit/9.0/fp-to-integer.md) -- [FromKeyedServicesAttribute no longer injects non-keyed parameter](../core/compatibility/core-libraries/9.0/non-keyed-params.md) -- [HttpClientFactory logging redacts header values by default](../core/compatibility/networking/9.0/redact-headers.md) -- [IMsoComponent support is opt-in](../core/compatibility/windows-forms/9.0/imsocomponent-support.md) -- [IncrementingPollingCounter initial callback is asynchronous](../core/compatibility/core-libraries/9.0/async-callback.md) -- [ZipArchiveEntry names and comments respect UTF8 flag](../core/compatibility/core-libraries/9.0/ziparchiveentry-encoding.md) +- [.NET Monitor images simplified to version-only tags](../core/compatibility/containers/9.0/monitor-images.md) +- [C# overload resolution prefers `params` span-type overloads](../core/compatibility/core-libraries/9.0/params-overloads.md) +- [Legacy Mono and Emscripten JavaScript APIs not exported to global namespace](../core/compatibility/aspnet-core/9.0/legacy-apis.md) +- [New version of some OOB packages](../core/compatibility/core-libraries/9.0/oob-packages.md) +- [Nullable JsonDocument properties deserialize to JsonValueKind.Null](../core/compatibility/serialization/9.0/jsondocument-props.md) +- [System.Windows.Forms.StatusStrip uses a different default renderer](../core/compatibility/windows-forms/9.0/statusstrip-renderer.md) ## .NET fundamentals ### New articles -- [Common `IHttpClientFactory` usage issues](../core/extensions/httpclient-factory-troubleshooting.md) -- [HttpWebRequest to HttpClient Migration Guide](../fundamentals/networking/http/httpclient-migrate-from-httpwebrequest.md) -- [Intrinsic APIs marked RequiresDynamicCode](../core/deploying/native-aot/intrinsic-requiresdynamiccode-apis.md) -- [Security features](../core/deploying/native-aot/security.md) +- [.NET debugger extensions](../core/diagnostics/debugger-extensions.md) +- [.NET debugger extensions installer (dotnet-debugger-extensions)](../core/diagnostics/dotnet-debugger-extensions.md) +- [Artificial intelligence in .NET (Preview)](../core/extensions/artificial-intelligence.md) +- [Built-in activities in .NET](../core/diagnostics/distributed-tracing-builtin-activities.md) +- [IL2123: `RequiresUnreferencedCodeAttribute` cannot be placed directly on application entry point](../core/deploying/trimming/trim-warnings/il2123.md) +- [IL3005: `RequiresAssemblyFilesAttribute` cannot be placed directly on application entry point](../core/deploying/single-file/warnings/il3005.md) +- [IL3057: `RequiresDynamicCodeAttribute` cannot be placed directly on application entry point](../core/deploying/native-aot/warnings/il3057.md) +- [The `TestContext` class](../core/testing/unit-testing-mstest-writing-tests-testcontext.md) +- [What is TimeProvider?](../standard/datetime/timeprovider-overview.md) ### Updated articles -- [How to customize property names and values with System.Text.Json](../standard/serialization/system-text-json/customize-properties.md) - Add Copilot use case -- [How to write .NET objects as JSON (serialize)](../standard/serialization/system-text-json/how-to.md) - Add GitHub Copilot use case to serialize JSON -- [MSBuild reference for .NET SDK projects](../core/project-sdk/msbuild-props.md) - Add MSBuild test-related properties -- [What's new in .NET libraries for .NET 9](../core/whats-new/dotnet-9/libraries.md) - What's new for .NET 9 RC 1 +- [Configure MSTest](../core/testing/unit-testing-mstest-configure.md) - MSTest: document testconfig.json +- [How to stream XML fragments from an XmlReader (LINQ to XML)](../standard/linq/stream-xml-fragments-xmlreader.md) - Fixed incorrect logic in XmlReader's example (#43799) +- [Supported types in System.Text.Json](../standard/serialization/system-text-json/supported-types.md) - Add supported types for STJ article ## C# language ### New articles -- [Resolve errors and warnings that affect overload resolution.](../csharp/language-reference/compiler-messages/overload-resolution.md) +- [Deconstruction expression - Extract properties of fields from a tuple or other user-defined type](../csharp/language-reference/operators/deconstruction.md) +- [Discard - A `_` acts as a placeholder for a variable](../csharp/language-reference/tokens/discard.md) -## Azure SDK for .NET +## F# language -### New articles +### Updated articles -- [Frequently asked questions](../azure/migration/appcat/faq.md) +- [Attributes (F#)](../fsharp/language-reference/attributes.md) - F# 9 doc updates -## .NET Framework +## AI in .NET + +### Updated articles + +- [Build a .NET AI vector search app](../ai/quickstarts/quickstart-ai-chat-with-data.md) - New vector search quickstart + +## ML.NET ### Updated articles -- [Migrating WSE 3.0 Web Services to WCF](../framework/wcf/feature-details/migrating-wse-3-0-web-services-to-wcf.md) - SFI: ROPC - another chunk +- [Machine learning tasks in ML.NET](../machine-learning/resources/tasks.md) - Add text classification and sentence similarity to ML tasks + +## .NET Framework + +### New articles + +- [Install .NET Framework on Windows Server 2025](../framework/install/on-server-2025.md) +- [November 2024 cumulative update preview](../framework/release-notes/2024/11-21-november-preview-cumulative-update.md) ## Community contributors The following people contributed to the .NET docs during this period. Thank you! Learn how to contribute by following the links under "Get involved" in the [what's new landing page](index.yml). -- [BartoszKlonowski](https://github.com/BartoszKlonowski) - Bartosz Klonowski ![3 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-3-green) -- [hakenr](https://github.com/hakenr) - Robert Haken ![3 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-3-green) -- [mpostol](https://github.com/mpostol) - Mariusz Postol ![2 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green) -- [Roshni-Gandhi](https://github.com/Roshni-Gandhi) - ![2 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green) -- [AptiviCEO](https://github.com/AptiviCEO) - Aptivi CEO ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [bb-froggy](https://github.com/bb-froggy) - Christoph Hannebauer ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- bravequickcleverfibreyarn - boldswiftsmartfiberhank ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [ChinoUkaegbu](https://github.com/ChinoUkaegbu) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [colejohnson66](https://github.com/colejohnson66) - Cole Tobin ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [da1910](https://github.com/da1910) - Doug Addy ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [geniuszxy](https://github.com/geniuszxy) - Shingo ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [Haidar0096](https://github.com/Haidar0096) - Haidar Mehsen ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [HEJOK254](https://github.com/HEJOK254) - Jakub Dębski ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [jairbubbles](https://github.com/jairbubbles) - Julien Richard ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [koenigst](https://github.com/koenigst) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [Legend4it](https://github.com/Legend4it) - Ali Abdulhussein ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [luizfls](https://github.com/luizfls) - Luiz Felipe Silva ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [melbasiouny](https://github.com/melbasiouny) - Mostafa ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [normandev92](https://github.com/normandev92) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [ousiax](https://github.com/ousiax) - Jon X ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [sammychinedu2ky](https://github.com/sammychinedu2ky) - Samson Amaugo ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [samwherever](https://github.com/samwherever) - Sam Allen ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [Smaug123](https://github.com/Smaug123) - Patrick Stevens ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [stashut](https://github.com/stashut) - Stanislav Hut ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [BartoszKlonowski](https://github.com/BartoszKlonowski) - Bartosz Klonowski ![2 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green) +- [DaRosenberg](https://github.com/DaRosenberg) - Daniel Rosenberg ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [DonCorleone](https://github.com/DonCorleone) - Linus Wieland ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [inwenis](https://github.com/inwenis) - fku-incom ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [jkone27](https://github.com/jkone27) - gparmigiani ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [Nothing-Works](https://github.com/Nothing-Works) - Andy ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [oksanatk](https://github.com/oksanatk) - Oksana Tkach ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [Rageking8](https://github.com/Rageking8) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [RaphaelSantiago53](https://github.com/RaphaelSantiago53) - Raphael ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [stamminator](https://github.com/stamminator) - Jacob Stamm ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) - [timdeschryver](https://github.com/timdeschryver) - Tim Deschryver ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [udidahan](https://github.com/udidahan) - Udi Dahan ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [xlxdxy](https://github.com/xlxdxy) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) -- [xparadoxical](https://github.com/xparadoxical) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [tmds](https://github.com/tmds) - Tom Deseyn ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) diff --git a/docs/whats-new/index.yml b/docs/whats-new/index.yml index 5a31f9a6207bd..1bb74505f4775 100644 --- a/docs/whats-new/index.yml +++ b/docs/whats-new/index.yml @@ -5,7 +5,7 @@ summary: Welcome to what's new in .NET and .NET docs. Use this page to navigate metadata: title: .NET what's new? description: Learn about new .NET features and new and updated content in .NET docs. - ms.date: 12/12/2024 + ms.date: 01/01/2025 ms.topic: landing-page landingContent: - title: .NET 9 release updates @@ -40,12 +40,12 @@ landingContent: linkLists: - linkListType: whats-new links: + - text: December 2024 + url: dotnet-docs-mod0.md - text: November 2024 url: dotnet-docs-mod2.md - text: October 2024 url: dotnet-docs-mod1.md - - text: September 2024 - url: dotnet-docs-mod0.md - title: Language updates linkLists: - linkListType: whats-new diff --git a/docs/whats-new/toc.yml b/docs/whats-new/toc.yml index 6b5e3a0b400f5..7a8e402de6943 100644 --- a/docs/whats-new/toc.yml +++ b/docs/whats-new/toc.yml @@ -6,12 +6,12 @@ items: - name: Latest documentation updates expanded: true items: + - name: December 2024 + href: dotnet-docs-mod0.md - name: November 2024 href: dotnet-docs-mod2.md - name: October 2024 href: dotnet-docs-mod1.md - - name: September 2024 - href: dotnet-docs-mod0.md - name: Product updates items: - name: .NET 9 diff --git a/includes/migration-guide/retargeting/core/allow-unicode-bidirectional-control-characters-uris.md b/includes/migration-guide/retargeting/core/allow-unicode-bidirectional-control-characters-uris.md index 08f76799e3271..b0d3926638fb2 100644 --- a/includes/migration-guide/retargeting/core/allow-unicode-bidirectional-control-characters-uris.md +++ b/includes/migration-guide/retargeting/core/allow-unicode-bidirectional-control-characters-uris.md @@ -14,7 +14,7 @@ For applications that target versions of .NET Framework starting with 4.7.2, sup ``` -For applications that target earlier versions of the .NET Framework but are running under versions starting with .NET Framework 4.7.2, support for Unicode bidirectional characters is disabled by default. You can enable it by adding the following [AppContextSwitchOverrides](~/docs/framework/configure-apps/file-schema/runtime/appcontextswitchoverrides-element.md) switch to the `` section of the application configuration file:: +For applications that target earlier versions of the .NET Framework but are running under versions starting with .NET Framework 4.7.2, support for Unicode bidirectional characters is disabled by default. You can enable it by adding the following [AppContextSwitchOverrides](~/docs/framework/configure-apps/file-schema/runtime/appcontextswitchoverrides-element.md) switch to the `` section of the application configuration file: ```xml