diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 9b0e0305d58b1..358ad42b97b48 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -29,7 +29,7 @@ | Conversational Language Understanding | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Language.Conversations/1.1.0)
NuGet [2.0.0-beta.3](https://www.nuget.org/packages/Azure.AI.Language.Conversations/2.0.0-beta.3) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_1.1.0/sdk/cognitivelanguage/Azure.AI.Language.Conversations/)
GitHub [2.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_2.0.0-beta.3/sdk/cognitivelanguage/Azure.AI.Language.Conversations/) | | Conversations Authoring | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Language.Conversations.Authoring/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations.Authoring-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations.Authoring_1.0.0-beta.2/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/) | | Core - Client - AMQP | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Core.Amqp/1.3.1) | [docs](/dotnet/api/overview/azure/Core.Amqp-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core.Amqp_1.3.1/sdk/core/Azure.Core.Amqp/) | -| Core - Client - Core | NuGet [1.47.3](https://www.nuget.org/packages/Azure.Core/1.47.3) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.47.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.47.3/sdk/core/Azure.Core/) | +| Core - Client - Core | NuGet [1.48.0](https://www.nuget.org/packages/Azure.Core/1.48.0) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.48.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.48.0/sdk/core/Azure.Core/) | | Core Newtonsoft Json | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Core.NewtonsoftJson/2.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.NewtonsoftJson-readme) | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.NewtonsoftJson_2.0.0/sdk/core/Microsoft.Azure.Core.NewtonsoftJson/) | | Core WCF Storage Queues | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Microsoft.CoreWCF.Azure.StorageQueues/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.CoreWCF.Azure.StorageQueues-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.CoreWCF.Azure.StorageQueues_1.0.0-beta.1/sdk/extension-wcf/Microsoft.CoreWCF.Azure.StorageQueues/) | | Data Movement | NuGet [12.2.1](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.2.1) | [docs](/dotnet/api/overview/azure/Storage.DataMovement-readme) | GitHub [12.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.2.1/sdk/storage/Azure.Storage.DataMovement/) | @@ -69,7 +69,6 @@ | Maps Search | NuGet [2.0.0-beta.5](https://www.nuget.org/packages/Azure.Maps.Search/2.0.0-beta.5) | [docs](/dotnet/api/overview/azure/Maps.Search-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [2.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Maps.Search_2.0.0-beta.5/sdk/maps/Azure.Maps.Search/) | | Media Analytics Edge | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Media.Analytics.Edge/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Media.Analytics.Edge-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Media.Analytics.Edge_1.0.0-beta.1/sdk/mediaservices/Azure.Media.Analytics.Edge) | | Metrics Advisor | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.MetricsAdvisor/1.1.0) | [docs](/dotnet/api/overview/azure/AI.MetricsAdvisor-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.MetricsAdvisor_1.1.0/sdk/metricsadvisor/Azure.AI.MetricsAdvisor/) | -| Microsoft Playwright Testing | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.Developer.MicrosoftPlaywrightTesting.TestLogger/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/Developer.MicrosoftPlaywrightTesting.TestLogger-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Developer.MicrosoftPlaywrightTesting.TestLogger_1.0.0-beta.4/sdk/playwrighttesting/Azure.Developer.MicrosoftPlaywrightTesting.TestLogger/) | | Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents | NuGet [1.1.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents/1.1.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents_1.1.0/sdk/entra/Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents/) | | Microsoft.Azure.WebPubSub.AspNetCore | NuGet [1.4.0](https://www.nuget.org/packages/Microsoft.Azure.WebPubSub.AspNetCore/1.4.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebPubSub.AspNetCore-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebPubSub.AspNetCore_1.4.0/sdk/webpubsub/Microsoft.Azure.WebPubSub.AspNetCore/) | | Microsoft.Azure.WebPubSub.Common | NuGet [1.4.0](https://www.nuget.org/packages/Microsoft.Azure.WebPubSub.Common/1.4.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebPubSub.Common-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebPubSub.Common_1.4.0/sdk/webpubsub/Microsoft.Azure.WebPubSub.Common/) | @@ -77,7 +76,6 @@ | Models Repository | NuGet [1.0.0-preview.6](https://www.nuget.org/packages/Azure.IoT.ModelsRepository/1.0.0-preview.6) | [docs](/dotnet/api/overview/azure/IoT.ModelsRepository-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-preview.6](https://github.com/Azure/azure-sdk-for-net/tree/Azure.IoT.ModelsRepository_1.0.0-preview.6/sdk/modelsrepository/Azure.IoT.ModelsRepository/) | | Monitor Ingestion | NuGet [1.2.0](https://www.nuget.org/packages/Azure.Monitor.Ingestion/1.2.0) | [docs](/dotnet/api/overview/azure/Monitor.Ingestion-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Monitor.Ingestion_1.2.0/sdk/monitor/Azure.Monitor.Ingestion/) | | Monitor Query | NuGet [1.7.1](https://www.nuget.org/packages/Azure.Monitor.Query/1.7.1) | [docs](/dotnet/api/overview/azure/Monitor.Query-readme) | GitHub [1.7.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Monitor.Query_1.7.1/sdk/monitor/Azure.Monitor.Query/) | -| NUnit ? Microsoft Playwright Testing | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.Developer.MicrosoftPlaywrightTesting.NUnit/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/Developer.MicrosoftPlaywrightTesting.NUnit-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Developer.MicrosoftPlaywrightTesting.NUnit_1.0.0-beta.4/sdk/playwrighttesting/Azure.Developer.MicrosoftPlaywrightTesting.NUnit/) | | OpenAI Assistants | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.AI.OpenAI.Assistants/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/AI.OpenAI.Assistants-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.OpenAI.Assistants_1.0.0-beta.4/sdk/openai/Azure.AI.OpenAI.Assistants/) | | OpenAI Inference | NuGet [2.1.0](https://www.nuget.org/packages/Azure.AI.OpenAI/2.1.0)
NuGet [2.3.0-beta.2](https://www.nuget.org/packages/Azure.AI.OpenAI/2.3.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.OpenAI-readme) | GitHub [2.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.OpenAI_2.1.0/sdk/openai/Azure.AI.OpenAI/)
GitHub [2.3.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.OpenAI_2.3.0-beta.2/sdk/openai/Azure.AI.OpenAI/) | | OpenTelemetry AspNetCore | NuGet [1.3.0](https://www.nuget.org/packages/Azure.Monitor.OpenTelemetry.AspNetCore/1.3.0) | [docs](/dotnet/api/overview/azure/Monitor.OpenTelemetry.AspNetCore-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Monitor.OpenTelemetry.AspNetCore_1.3.0/sdk/monitor/Azure.Monitor.OpenTelemetry.AspNetCore/) | @@ -258,7 +256,7 @@ | Resource Management - Event Grid | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.1.0)
NuGet [1.2.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.2.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.EventGrid-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.1.0/sdk/eventgrid/Azure.ResourceManager.EventGrid/)
GitHub [1.2.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.2.0-beta.2/sdk/eventgrid/Azure.ResourceManager.EventGrid/) | | Resource Management - Event Hubs | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.EventHubs/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.EventHubs-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventHubs_1.2.0/sdk/eventhub/Azure.ResourceManager.EventHubs/) | | Resource Management - Extended Location | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.ExtendedLocations/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ExtendedLocations-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ExtendedLocations_1.1.1/sdk/extendedlocation/Azure.ResourceManager.ExtendedLocations/) | -| Resource Management - Fabric | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Fabric/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Fabric-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.Fabric_1.0.0-beta.2/sdk/fabric/Azure.ResourceManager.Fabric/) | +| Resource Management - Fabric | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Fabric/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Fabric-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Fabric_1.0.0/sdk/fabric/Azure.ResourceManager.Fabric/) | | Resource Management - Fluid Relay | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.FluidRelay/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.FluidRelay-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.FluidRelay_1.1.1/sdk/fluidrelay/Azure.ResourceManager.FluidRelay/) | | Resource Management - Front Door | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.FrontDoor/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.FrontDoor-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.FrontDoor_1.4.0/sdk/frontdoor/Azure.ResourceManager.FrontDoor/) | | Resource Management - Graph Services | NuGet [1.1.2](https://www.nuget.org/packages/Azure.ResourceManager.GraphServices/1.1.2) | [docs](/dotnet/api/overview/azure/ResourceManager.GraphServices-readme) | GitHub [1.1.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.GraphServices_1.1.2/sdk/graphservices/Azure.ResourceManager.GraphServices/) | @@ -324,7 +322,6 @@ | Resource Management - Pineconevectordb | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.PineconeVectorDB/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.PineconeVectorDB-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.PineconeVectorDB_1.0.0-beta.1/sdk/pineconevectordb/Azure.ResourceManager.PineconeVectorDB/) | | Resource Management - Planetarycomputer | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.PlanetaryComputer/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.PlanetaryComputer-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.PlanetaryComputer_1.0.0-beta.1/sdk/planetarycomputer/Azure.ResourceManager.PlanetaryComputer/) | | Resource Management - Playwright | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Playwright/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Playwright-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Playwright_1.0.0/sdk/playwright/Azure.ResourceManager.Playwright/) | -| Resource Management - Playwright Testing | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.PlaywrightTesting/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.PlaywrightTesting-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.PlaywrightTesting_1.0.0/sdk/playwrighttesting/Azure.ResourceManager.PlaywrightTesting/) | | Resource Management - Policy Insights | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.PolicyInsights/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.PolicyInsights-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.PolicyInsights_1.2.1/sdk/policyinsights/Azure.ResourceManager.PolicyInsights/) | | Resource Management - Portalservicescopilot | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.PortalServicesCopilot/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.PortalServicesCopilot-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.PortalServicesCopilot_1.0.0-beta.1/sdk/portalservices/Azure.ResourceManager.PortalServicesCopilot/) | | Resource Management - PostgreSQL | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.PostgreSql/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.PostgreSql-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.PostgreSql_1.3.1/sdk/postgresql/Azure.ResourceManager.PostgreSql/) | @@ -520,7 +517,7 @@ | Functions extension for RabbitMQ | NuGet [2.1.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.RabbitMQ/2.1.0) | | GitHub [2.1.0](https://github.com/Azure/azure-functions-rabbitmq-extension/tree/v0.2.2029-beta) | | Functions extension for script abstractions | NuGet [1.0.4-preview](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Script.Abstractions/1.0.4-preview) | | | | Functions extension for SendGrid | NuGet [3.1.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.SendGrid/3.1.0) | | GitHub [3.1.0](https://github.com/Azure/azure-webjobs-sdk-extensions/tree/v3.0.0/src/WebJobs.Extensions.SendGrid) | -| Functions extension for Sources | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Sources/3.0.41) | | GitHub [3.0.41](https://github.com/Azure/azure-webjobs-sdk) | +| Functions extension for Sources | NuGet [3.0.42](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Sources/3.0.42) | | GitHub [3.0.42](https://github.com/Azure/azure-webjobs-sdk) | | Functions extension for Storage Timers | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Timers.Storage/1.0.0) | | | | Functions extension for Twilio | NuGet [3.0.2](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Twilio/3.0.2) | | GitHub [3.0.2](https://github.com/Azure/azure-webjobs-sdk-extensions/tree/v3.0.0/src/WebJobs.Extensions.Twilio) | | Functions extension metadata generator | NuGet [4.0.1](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Script.ExtensionsMetadataGenerator/4.0.1) | | GitHub [4.0.1](https://github.com/Azure/azure-functions-host) | @@ -537,7 +534,7 @@ | Functions project template pack for Microsoft Template Engine | NuGet [4.0.5212](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.ProjectTemplates/4.0.5212) | | GitHub [4.0.5212](https://github.com/Azure/azure-functions-templates/tree/3.1.1582) | | Functions runtime assemblies for App Insights logging | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Logging.ApplicationInsights/3.0.41) | | GitHub [3.0.41](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18/src/Microsoft.Azure.WebJobs.Logging.ApplicationInsights) | | Functions runtime assemblies for logging | NuGet [4.0.3](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Logging/4.0.3) | | GitHub [4.0.3](https://github.com/Azure/azure-webjobs-sdk/tree/dev/src/Microsoft.Azure.WebJobs.Logging) | -| Functions runtime assemblies for Microsoft.Azure.WebJobs.Host | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs/3.0.41) | | GitHub [3.0.41](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18/src/Microsoft.Azure.WebJobs) | +| Functions runtime assemblies for Microsoft.Azure.WebJobs.Host | NuGet [3.0.42](https://www.nuget.org/packages/Microsoft.Azure.WebJobs/3.0.42) | | GitHub [3.0.42](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18/src/Microsoft.Azure.WebJobs) | | Functions timers and file triggers | NuGet [5.0.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions/5.0.0) | | GitHub [5.0.0](https://github.com/Azure/azure-webjobs-sdk-extensions/tree/dev/src/WebJobs.Extensions) | | Microsoft.Azure.Cosmos.Templates | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Templates/1.0.0) | | | | Microsoft.Azure.Functions.Analyzers | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Analyzers/1.0.0) | | | @@ -575,20 +572,20 @@ | Microsoft.Azure.Functions.Worker.Sdk.Generators | NuGet [1.3.5](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Sdk.Generators/1.3.5) | | | | Microsoft.Azure.WebJobs.CosmosDb.ChangeProcessor | NuGet [1.0.4](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.CosmosDb.ChangeProcessor/1.0.4) | | | | Microsoft.Azure.WebJobs.Extensions.Kusto | NuGet [1.0.13-Preview](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Kusto/1.0.13-Preview) | | | -| Microsoft.Azure.WebJobs.Extensions.Rpc | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Rpc/3.0.41) | | | +| Microsoft.Azure.WebJobs.Extensions.Rpc | NuGet [3.0.42](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Rpc/3.0.42) | | | | Microsoft.Azure.WebJobs.Rpc.Core | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Rpc.Core/3.0.41) | | | | Service Bus - Message ID plugin | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.ServiceBus.MessageIdPlugin/2.0.0) | | | -| SignalR | NuGet [1.31.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR/1.31.0)
NuGet [1.25.0-preview1-11147](https://www.nuget.org/packages/Microsoft.Azure.SignalR/1.25.0-preview1-11147) | | GitHub [1.31.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR) | -| SignalR - ASP.NET | NuGet [1.31.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.AspNet/1.31.0) | | GitHub [1.31.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR.AspNet) | +| SignalR | NuGet [1.32.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR/1.32.0)
NuGet [1.25.0-preview1-11147](https://www.nuget.org/packages/Microsoft.Azure.SignalR/1.25.0-preview1-11147) | | GitHub [1.32.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR) | +| SignalR - ASP.NET | NuGet [1.32.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.AspNet/1.32.0) | | GitHub [1.32.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR.AspNet) | | SignalR - Benchmark | NuGet [1.0.0-preview1-10415](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Benchmark/1.0.0-preview1-10415) | | GitHub [1.0.0-preview1-10415](https://github.com/azure/azure-signalr-bench) | -| SignalR - Protocols | NuGet [1.31.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Protocols/1.31.0) | | GitHub [1.31.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR.Protocols) | +| SignalR - Protocols | NuGet [1.32.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Protocols/1.32.0) | | GitHub [1.32.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR.Protocols) | | SignalR - Serverless Protocols | NuGet [1.11.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Serverless.Protocols/1.11.0) | | GitHub [1.11.0](https://github.com/Azure/azure-functions-signalrservice-extension/tree/v1.2.0/src/Microsoft.Azure.SignalR.Serverless.Protocols) | -| SignalR Management | NuGet [1.31.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Management/1.31.0) | | GitHub [1.31.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR.Management) | +| SignalR Management | NuGet [1.32.0](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Management/1.32.0) | | GitHub [1.32.0](https://github.com/Azure/azure-signalr/tree/v1.5.0/src/Microsoft.Azure.SignalR.Management) | | SQL Database Elastic Scale Client | NuGet [2.4.2](https://www.nuget.org/packages/Microsoft.Azure.SqlDatabase.ElasticScale.Client/2.4.2) | | GitHub [2.4.2](https://github.com/Azure/elastic-db-tools/tree/v2.3.0/Src/ElasticScale.Client) | | SQL Database Elastic Scale Service SplitMerge | NuGet [1.2.0](https://www.nuget.org/packages/Microsoft.Azure.SqlDatabase.ElasticScale.Service.SplitMerge/1.2.0) | | | | SQL Database Jobs | NuGet [0.8.3362.1](https://www.nuget.org/packages/Microsoft.Azure.SqlDatabase.Jobs/0.8.3362.1) | | | | Storage APIs for Microsoft.Azure.WebJobs.Host | NuGet [5.0.1](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Host.Storage/5.0.1) | | GitHub [5.0.1](https://github.com/Azure/azure-webjobs-sdk/tree/storage-v4.0.1/src/Microsoft.Azure.WebJobs.Host.Storage) | -| Supporting library for Microsoft.Azure.WebJobs | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Core/3.0.41) | | GitHub [3.0.41](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18) | +| Supporting library for Microsoft.Azure.WebJobs | NuGet [3.0.42](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Core/3.0.42) | | GitHub [3.0.42](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18) | | Supporting library for Microsoft.Azure.WebJobs.Extensions.OpenApi | NuGet [1.4.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.OpenApi.Core/1.4.0)
NuGet [2.0.0-preview2](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.OpenApi.Core/2.0.0-preview2) | | | | Supporting library for testing Microsoft.Azure.WebJobs.Host | NuGet [3.0.41](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Host.TestCommon/3.0.41) | | GitHub [3.0.41](https://github.com/Azure/azure-webjobs-sdk) | | Web - Redis Output Cache Provider | NuGet [4.0.1](https://www.nuget.org/packages/Microsoft.Web.RedisOutputCacheProvider/4.0.1) | | GitHub [4.0.1](https://github.com/Azure/aspnet-redis-providers/tree/NuGet-Release/RedisOutputCacheProvider-3.0.1/src/OutputCacheProvider) | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index 1aa1182327901..dd66899db0031 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -31,7 +31,7 @@ | Conversational Language Understanding | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Language.Conversations/1.1.0)
NuGet [2.0.0-beta.3](https://www.nuget.org/packages/Azure.AI.Language.Conversations/2.0.0-beta.3) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_1.1.0/sdk/cognitivelanguage/Azure.AI.Language.Conversations/)
GitHub [2.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_2.0.0-beta.3/sdk/cognitivelanguage/Azure.AI.Language.Conversations/) | | Conversations Authoring | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Language.Conversations.Authoring/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations.Authoring-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations.Authoring_1.0.0-beta.2/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/) | | Core - Client - AMQP | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Core.Amqp/1.3.1) | [docs](/dotnet/api/overview/azure/Core.Amqp-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core.Amqp_1.3.1/sdk/core/Azure.Core.Amqp/) | -| Core - Client - Core | NuGet [1.47.3](https://www.nuget.org/packages/Azure.Core/1.47.3) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.47.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.47.3/sdk/core/Azure.Core/) | +| Core - Client - Core | NuGet [1.48.0](https://www.nuget.org/packages/Azure.Core/1.48.0) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.48.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.48.0/sdk/core/Azure.Core/) | | Core Newtonsoft Json | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Core.NewtonsoftJson/2.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.NewtonsoftJson-readme) | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.NewtonsoftJson_2.0.0/sdk/core/Microsoft.Azure.Core.NewtonsoftJson/) | | Core WCF Storage Queues | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Microsoft.CoreWCF.Azure.StorageQueues/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.CoreWCF.Azure.StorageQueues-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.CoreWCF.Azure.StorageQueues_1.0.0-beta.1/sdk/extension-wcf/Microsoft.CoreWCF.Azure.StorageQueues/) | | Data Movement | NuGet [12.2.1](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.2.1) | [docs](/dotnet/api/overview/azure/Storage.DataMovement-readme) | GitHub [12.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.2.1/sdk/storage/Azure.Storage.DataMovement/) | @@ -266,7 +266,7 @@ | Resource Management - Event Grid | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.1.0)
NuGet [1.2.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.EventGrid/1.2.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.EventGrid-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.1.0/sdk/eventgrid/Azure.ResourceManager.EventGrid/)
GitHub [1.2.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventGrid_1.2.0-beta.2/sdk/eventgrid/Azure.ResourceManager.EventGrid/) | | Resource Management - Event Hubs | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.EventHubs/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.EventHubs-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.EventHubs_1.2.0/sdk/eventhub/Azure.ResourceManager.EventHubs/) | | Resource Management - Extended Location | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.ExtendedLocations/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ExtendedLocations-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ExtendedLocations_1.1.1/sdk/extendedlocation/Azure.ResourceManager.ExtendedLocations/) | -| Resource Management - Fabric | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Fabric/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Fabric-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.Fabric_1.0.0-beta.2/sdk/fabric/Azure.ResourceManager.Fabric/) | +| Resource Management - Fabric | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Fabric/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Fabric-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Fabric_1.0.0/sdk/fabric/Azure.ResourceManager.Fabric/) | | Resource Management - Fluid Relay | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.FluidRelay/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.FluidRelay-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.FluidRelay_1.1.1/sdk/fluidrelay/Azure.ResourceManager.FluidRelay/) | | Resource Management - Front Door | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.FrontDoor/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.FrontDoor-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.FrontDoor_1.4.0/sdk/frontdoor/Azure.ResourceManager.FrontDoor/) | | Resource Management - Graph Services | NuGet [1.1.2](https://www.nuget.org/packages/Azure.ResourceManager.GraphServices/1.1.2) | [docs](/dotnet/api/overview/azure/ResourceManager.GraphServices-readme) | GitHub [1.1.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.GraphServices_1.1.2/sdk/graphservices/Azure.ResourceManager.GraphServices/) | diff --git a/docs/core/compatibility/10.0.md b/docs/core/compatibility/10.0.md index 4e5618060e500..8cb077face469 100644 --- a/docs/core/compatibility/10.0.md +++ b/docs/core/compatibility/10.0.md @@ -2,7 +2,7 @@ title: Breaking changes in .NET 10 titleSuffix: "" description: Navigate to the breaking changes in .NET 10. -ms.date: 08/08/2025 +ms.date: 09/09/2025 ai-usage: ai-assisted no-loc: [Blazor, Razor, Kestrel] --- @@ -27,6 +27,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [IPNetwork and ForwardedHeadersOptions.KnownNetworks are obsolete](aspnet-core/10/ipnetwork-knownnetworks-obsolete.md) | Source incompatible | Preview 7 | | [Microsoft.Extensions.ApiDescription.Client package deprecated](aspnet-core/10/apidescription-client-deprecated.md) | Source incompatible | Preview 7 | | [Razor run-time compilation is obsolete](aspnet-core/10/razor-runtime-compilation-obsolete.md) | Source incompatible | Preview 7 | +| [WebHostBuilder, IWebHost, and WebHost are obsolete](aspnet-core/10/webhostbuilder-deprecated.md) | Source incompatible | RC 1 | ## Containers @@ -54,6 +55,17 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [System.Linq.AsyncEnumerable included in core libraries](core-libraries/10.0/asyncenumerable.md) | Source incompatible | Preview 1 | | [YMM embedded rounding removed from AVX10.2](core-libraries/10.0/ymm-embedded-rounding.md) | Behavioral change | Preview 5 | +## Cryptography + +| Title | Type of change | Introduced version | +|-------|-------------------|--------------------| +| [CoseSigner.Key can be null](cryptography/10.0/cosesigner-key-null.md) | Behavioral/source incompatible change | Preview 7 | +| [MLDsa and SlhDsa 'SecretKey' members renamed](cryptography/10.0/mldsa-slhdsa-secretkey-to-privatekey.md) | Source incompatible | RC 1 | +| [OpenSSL cryptographic primitives aren't supported on macOS](cryptography/10.0/openssl-macos-unsupported.md) | Behavioral change | Preview 6 | +| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 | +| [X509Certificate and PublicKey key parameters can be null](cryptography/10.0/x509-publickey-null.md) | Behavioral/source incompatible change | Preview 3 | +| [Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE](cryptography/10.0/version-override.md) | Behavioral change | Preview 1 | + ## Entity Framework Core [Breaking changes in EF Core 10](/ef/core/what-is-new/ef-core-10.0/breaking-changes) @@ -73,16 +85,6 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af |-------|-------------------|--------------------| | [Environment variable renamed to DOTNET_ICU_VERSION_OVERRIDE](globalization/10.0/version-override.md) | Behavioral change | Preview 1 | -## Cryptography - -| Title | Type of change | Introduced version | -|-------|-------------------|--------------------| -| [CoseSigner.Key can be null](cryptography/10.0/cosesigner-key-null.md) | Behavioral/source incompatible change | Preview 7 | -| [OpenSSL cryptographic primitives aren't supported on macOS](cryptography/10.0/openssl-macos-unsupported.md) | Behavioral change | Preview 6 | -| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 | -| [X509Certificate and PublicKey key parameters can be null](cryptography/10.0/x509-publickey-null.md) | Behavioral/source incompatible change | Preview 3 | -| [Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE](cryptography/10.0/version-override.md) | Behavioral change | Preview 1 | - ## Interop | Title | Type of change | Introduced version | @@ -109,6 +111,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [`dotnet new sln` defaults to SLNX file format](sdk/10.0/dotnet-new-sln-slnx-default.md) | Behavioral change | RC 1 | | [`dotnet package list` performs restore](sdk/10.0/dotnet-package-list-restore.md) | Behavioral change | Preview 4 | | [`dotnet restore` audits transitive packages](sdk/10.0/nugetaudit-transitive-packages.md) | Behavioral change | Preview 3 | +| [`dotnet tool install --local` creates manifest by default](sdk/10.0/dotnet-tool-install-local-manifest.md) | Behavioral change | Preview 7 | | [project.json not supported in `dotnet restore`](sdk/10.0/dotnet-restore-project-json-unsupported.md) | Source incompatible | Preview 7 | | [SHA-1 fingerprint support deprecated in `dotnet nuget sign`](sdk/10.0/dotnet-nuget-sign-sha1-deprecated.md) | Behavioral change | Preview 1 | | [MSBUILDCUSTOMBUILDEVENTWARNING escape hatch removed](sdk/10.0/custom-build-event-warning.md) | Behavioral change | Preview 1 | @@ -119,6 +122,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [PrunePackageReference privatizes direct prunable references](sdk/10.0/prune-packagereference-privateassets.md) | Behavioral change | Preview 7 | | [HTTP warnings promoted to errors in `dotnet package list` and `dotnet package search`](sdk/10.0/http-warnings-to-errors.md) | Behavioral/source incompatible change | Preview 4 | | [NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed](sdk/10.0/nuget-enhanced-http-retry-removed.md) | Behavioral change | Preview 6 | +| [NuGet logs an error for invalid package IDs](sdk/10.0/nuget-packageid-validation.md) | Behavioral change | RC 1 | ## Windows Forms diff --git a/docs/core/compatibility/aspnet-core/10/webhostbuilder-deprecated.md b/docs/core/compatibility/aspnet-core/10/webhostbuilder-deprecated.md new file mode 100644 index 0000000000000..f95dec2bdbf70 --- /dev/null +++ b/docs/core/compatibility/aspnet-core/10/webhostbuilder-deprecated.md @@ -0,0 +1,87 @@ +--- +title: "WebHostBuilder, IWebHost, and WebHost are obsolete" +description: "Learn about the breaking change in ASP.NET Core 10 where WebHostBuilder, IWebHost, and WebHost are marked as obsolete." +ms.date: 09/05/2025 +ai-usage: ai-generated +ms.custom: https://github.com/aspnet/Announcements/issues/526 +--- + +# WebHostBuilder, IWebHost, and WebHost are obsolete + +, , and have been marked as obsolete in .NET 10. `WebHostBuilder` was replaced by `HostBuilder` ([generic host](/aspnet/core/fundamentals/host/generic-host)) in ASP.NET Core 3.0, and `WebApplicationBuilder` was introduced in ASP.NET Core 6.0. These newer alternatives are where future investments will occur. + +## Version introduced + +.NET 10 RC 1 + +## Previous behavior + +Previously, you could use `WebHostBuilder` to configure and build a web host without any compile-time warnings. + +## New behavior + +Starting in .NET 10, using `WebHostBuilder` produces a compiler warning with diagnostic ID `ASPDEPR004`: + +> warning ASPDEPR004: WebHostBuilder is deprecated in favor of HostBuilder and WebApplicationBuilder. For more information, visit . + +Using `IWebHost` or `WebHost` produces a compiler warning with diagnostic ID `ASPDEPR008`: + +> warning ASPDEPR008: WebHost is obsolete. Use HostBuilder or WebApplicationBuilder instead. For more information, visit . + +## Type of breaking change + +This change can affect [source compatibility](../../categories.md#source-compatibility). + +## Reason for change + +`HostBuilder` and have all the features of `WebHostBuilder` and are the focus of future investment. `WebHostBuilder` was replaced by the generic host in ASP.NET Core 3.0, and minimal APIs with were introduced in ASP.NET Core 6.0. These newer hosting models provide better integration with the .NET ecosystem and are the recommended approach for new applications. + +## Recommended action + +Migrate from `WebHostBuilder` to either [`HostBuilder`](/aspnet/core/fundamentals/host/generic-host) or [`WebApplication`](/aspnet/core/fundamentals/minimal-apis/webapplication): + +- For applications that need the full hosting capabilities, migrate to `HostBuilder`: + + **Before:** + + ```csharp + var hostBuilder = new WebHostBuilder() + .UseContentRoot(Directory.GetCurrentDirectory()) + .UseStartup() + .UseKestrel(); + // Test code might use TestServer: + var testServer = new TestServer(hostBuilder); + ``` + + **After:** + + ```csharp + using var host = new HostBuilder() + .ConfigureWebHost(webHostBuilder => + { + webHostBuilder + .UseTestServer() // If using TestServer. + .UseContentRoot(Directory.GetCurrentDirectory()) + .UseStartup() + .UseKestrel(); + }) + .Build(); + await host.StartAsync(); + + var testServer = host.GetTestServer(); + ``` + +- For new applications, especially those using minimal APIs, migrate to . + +## Affected APIs + +- +- +- + +## See also + +- [Generic Host in ASP.NET Core](/aspnet/core/fundamentals/host/generic-host) +- [Minimal APIs with WebApplication](/aspnet/core/fundamentals/minimal-apis/webapplication) +- [HostBuilder replaces WebHostBuilder](/aspnet/core/migration/22-to-30#hostbuilder-replaces-webhostbuilder) +- [Introducing WebApplication](/aspnet/core/migration/50-to-60#new-hosting-model) diff --git a/docs/core/compatibility/core-libraries/10.0/obsolete-apis.md b/docs/core/compatibility/core-libraries/10.0/obsolete-apis.md index 797c61c39f824..603875dc29d7c 100644 --- a/docs/core/compatibility/core-libraries/10.0/obsolete-apis.md +++ b/docs/core/compatibility/core-libraries/10.0/obsolete-apis.md @@ -2,7 +2,7 @@ title: "Breaking change: .NET 10 obsoletions with custom IDs" titleSuffix: "" description: Learn about the APIs that have been marked as obsolete in .NET 10 with a custom diagnostic ID. -ms.date: 03/28/2025 +ms.date: 09/08/2025 ai-usage: ai-assisted --- # API obsoletions with non-default diagnostic IDs (.NET 10) @@ -21,6 +21,7 @@ The following table lists the custom diagnostic IDs and their corresponding warn | [SYSLIB0059](../../../../fundamentals/syslib-diagnostics/syslib0059.md) | callbacks aren't run before the process exits. Use instead. | Warning | | [SYSLIB0060](../../../../fundamentals/syslib-diagnostics/syslib0060.md) | constructors are obsolete. Use instead. | Warning | | [SYSLIB0061](../../../../fundamentals/syslib-diagnostics/syslib0061.md) | and taking an `IComparer` are obsolete. Use the new ones that take an `IComparer`. | Warning | +| [SYSLIB0062](../../../../fundamentals/syslib-diagnostics/syslib0062.md) | is obsolete. | Warning | ## Version introduced @@ -64,6 +65,10 @@ These obsoletions can affect [source compatibility](../../categories.md#source-c - - +### SYSLIB0062 + +- + ## See also - [API obsoletions with non-default diagnostic IDs (.NET 9)](../9.0/obsolete-apis-with-custom-diagnostics.md) diff --git a/docs/core/compatibility/cryptography/10.0/mldsa-slhdsa-secretkey-to-privatekey.md b/docs/core/compatibility/cryptography/10.0/mldsa-slhdsa-secretkey-to-privatekey.md new file mode 100644 index 0000000000000..308900af099c6 --- /dev/null +++ b/docs/core/compatibility/cryptography/10.0/mldsa-slhdsa-secretkey-to-privatekey.md @@ -0,0 +1,52 @@ +--- +title: "Breaking change - MLDsa and SlhDsa 'SecretKey' members renamed" +description: "Learn about the breaking change in .NET 10 where MLDsa and SlhDsa members were renamed from using 'SecretKey' to using 'PrivateKey'." +ms.date: 09/05/2025 +ai-usage: ai-assisted +ms.custom: https://github.com/dotnet/docs/issues/47691 +--- + +# MLDsa and SlhDsa 'SecretKey' members renamed + +Some methods and properties in the `[Experimental]` post-quantum cryptography (PQC) classes and have been renamed. APIs that involve the `sk` value from their respective specifications now have `PrivateKey` in their names instead of `SecretKey`. + +## Version introduced + +.NET 10 RC 1 + +## Previous behavior + +Previously, you could call methods like `ImportMLDsaSecretKey` and `ImportSlhDsaSecretKey`, and you could access properties like `SecretKeySizeInBytes`. + +## New behavior + +Starting in .NET 10 RC 1, you must call methods like `ImportMLDsaPrivateKey` or `ImportSlhDsaPrivateKey`, and access properties like `PrivateKeySizeInBytes`. + +## Type of breaking change + +This change can affect [source compatibility](../../categories.md#source-compatibility). + +## Reason for change + +The change was made to align with existing asymmetric cryptography types in .NET and with related members such as . + +## Recommended action + +Resolve any compile breaks from this change by replacing instances of `SecretKey` with `PrivateKey` in the called member names: + +```diff +-int targetSize = key.Algorithm.SecretKeySizeInBytes; ++int targetSize = key.Algorithm.PrivateKeySizeInBytes; +byte[] output = new byte[targetSize]; +-key.ExportMLDsaSecretKey(output); ++key.ExportMLDsaPrivateKey(output); +``` + +## Affected APIs + +- +- +- +- +- +- diff --git a/docs/core/compatibility/sdk/10.0/dotnet-tool-install-local-manifest.md b/docs/core/compatibility/sdk/10.0/dotnet-tool-install-local-manifest.md new file mode 100644 index 0000000000000..e4bdb22384e15 --- /dev/null +++ b/docs/core/compatibility/sdk/10.0/dotnet-tool-install-local-manifest.md @@ -0,0 +1,46 @@ +--- +title: "Breaking change: 'dotnet tool install --local' creates manifest by default" +description: "Learn about the breaking change where 'dotnet tool install --local' now creates a manifest by default if no tools manifest is found." +ms.date: 08/27/2025 +ai-usage: ai-generated +--- + +# dotnet tool install --local creates manifest by default + +When running [`dotnet tool install --local`](../../../tools/dotnet-tool-install.md), a manifest is now created if none exists instead of failing with an error. This change was implemented by making the [`--create-manifest-if-needed` option](../../../tools/dotnet-tool-install.md#options) enabled by default. This is a breaking change, since users might have relied on the failure behavior to check if they needed to create a manifest. + +The `-d` flag on `dotnet tool install` was previously added to show the locations that were searched for manifests. This information was relayed in the error given when there was no manifest. That error is no longer shown since a manifest is now created if necessary. You should no longer use the `-d` flag. + +## Version introduced + +.NET 10 Preview 7 + +## Previous behavior + +Previously, if you tried to install a .NET tool as a local tool in a folder that didn't contain a manifest, you got an error: + +> Cannot find a manifest file. + +## New behavior + +Starting in .NET 10, the `--create-manifest-if-needed=true` functionality is now enabled by default. When a tool is installed as a local tool, the manifest is created automatically if it doesn't exist. The manifest is created according to the rules described in the [`--create-manifest-if-needed` option](../../../tools/dotnet-tool-install.md#options) documentation. + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +This change improves the user experience by making `dotnet tool install --local` work by default without requiring users to manually create a manifest first. Previously, there was a concern about creating a manifest in a working directory rather than the repository root, but the tool now puts the manifest in the repository root when possible. + +## Recommended action + +You can turn off the automatic manifest creation behavior by passing `--create-manifest-if-needed=false` when calling `dotnet tool install --local`. + +## Affected APIs + +N/A + +## See also + +- [dotnet tool install](../../../tools/dotnet-tool-install.md) diff --git a/docs/core/compatibility/sdk/10.0/nuget-packageid-validation.md b/docs/core/compatibility/sdk/10.0/nuget-packageid-validation.md new file mode 100644 index 0000000000000..bfa40997be2b0 --- /dev/null +++ b/docs/core/compatibility/sdk/10.0/nuget-packageid-validation.md @@ -0,0 +1,38 @@ +--- +title: "Breaking change: NuGet logs an error for invalid package IDs" +description: "Learn about the breaking change in .NET 10 where NuGet validates package IDs when constructing URLs and throws exceptions for invalid formats." +ms.date: 09/08/2025 +ai-usage: ai-assisted +ms.custom: https://github.com/dotnet/docs/issues/47984 +--- +# NuGet logs an error for invalid package IDs + +NuGet now validates package IDs when they're used to create URLs in .NET 10. If a package ID isn't in the correct format, NuGet shows an error instead of continuing. This ensures only valid package IDs are used when constructing URLs. + +## Version introduced + +.NET 10 RC 1 + +## Previous behavior + +Previously, NuGet resources that constructed URLs from package IDs did not validate the package ID format. Invalid or malformed package IDs could be used without triggering validation errors. + +## New behavior + +Starting with the .NET 10 SDK, any package ID used to construct a URL via NuGet resources is now validated. If the package ID doesn't conform to NuGet's expected format, an exception is thrown, and the URL is not constructed. + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +This change introduces validation to ensure that only properly formatted package IDs are used when constructing URLs. The validation strengthens the code's security posture by reducing the risk of unsafe or unintended inputs being processed. + +## Recommended action + +To disable the package ID validation logic and restore the previous behavior, you can set the environment variable `NUGET_DISABLE_PACKAGEID_VALIDATION` to `true`. + +## Affected APIs + +None. diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index e3a848bbafc0e..2484881f84725 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -26,6 +26,8 @@ items: href: aspnet-core/10/apidescription-client-deprecated.md - name: Razor run-time compilation is obsolete href: aspnet-core/10/razor-runtime-compilation-obsolete.md + - name: WebHostBuilder, IWebHost, and WebHost are obsolete + href: aspnet-core/10/webhostbuilder-deprecated.md - name: Containers items: - name: Default .NET images use Ubuntu @@ -70,6 +72,8 @@ items: href: cryptography/10.0/cosesigner-key-null.md - name: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE href: cryptography/10.0/version-override.md + - name: MLDsa and SlhDsa 'SecretKey' members renamed + href: cryptography/10.0/mldsa-slhdsa-secretkey-to-privatekey.md - name: OpenSSL cryptographic primitives not supported on macOS href: cryptography/10.0/openssl-macos-unsupported.md - name: X500DistinguishedName validation is stricter @@ -124,6 +128,8 @@ items: href: sdk/10.0/dotnet-new-sln-slnx-default.md - name: "`dotnet package list` performs restore" href: sdk/10.0/dotnet-package-list-restore.md + - name: "`dotnet tool install --local` creates manifest by default" + href: sdk/10.0/dotnet-tool-install-local-manifest.md - name: MSBUILDCUSTOMBUILDEVENTWARNING escape hatch removed href: sdk/10.0/custom-build-event-warning.md - name: MSBuild custom culture resource handling @@ -140,6 +146,8 @@ items: href: sdk/10.0/http-warnings-to-errors.md - name: NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed href: sdk/10.0/nuget-enhanced-http-retry-removed.md + - name: NuGet logs an error for invalid package IDs + href: sdk/10.0/nuget-packageid-validation.md - name: Windows Forms items: - name: API obsoletions diff --git a/docs/core/compatibility/unsupported-apis.md b/docs/core/compatibility/unsupported-apis.md index d230d80991bad..36b703f05db71 100644 --- a/docs/core/compatibility/unsupported-apis.md +++ b/docs/core/compatibility/unsupported-apis.md @@ -2,7 +2,7 @@ title: Unsupported APIs on .NET Core and .NET 5+ titleSuffix: "" description: Learn which .NET APIs always throw an exception on .NET Core and .NET 5 and later versions. -ms.date: 11/22/2024 +ms.date: 09/08/2025 --- # APIs that always throw exceptions on .NET Core and .NET 5+ @@ -349,6 +349,7 @@ This article organizes the affected APIs by namespace. | | All | | | All | | | All | +| (when set to `true`) | All | ## See also diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index b5c57947ad307..4df02338589a7 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -1,7 +1,7 @@ --- title: dotnet tool install command description: The dotnet tool install command installs the specified .NET tool on your machine. -ms.date: 04/07/2025 +ms.date: 08/27/2025 --- # dotnet tool install @@ -46,9 +46,9 @@ dotnet tool install -h|--help The `dotnet tool install` command provides a way for you to install .NET tools on your machine. To use the command, you specify one of the following installation options: -* To install a global tool in the default location, use the `--global` option. -* To install a global tool in a custom location, use the `--tool-path` option. -* To install a local tool, omit the `--global` and `--tool-path` options. +- To install a global tool in the default location, use the `--global` option. +- To install a global tool in a custom location, use the `--tool-path` option. +- To install a local tool, omit the `--global` and `--tool-path` options. > [!WARNING] > Make sure the directory you specify with the `--tool-path` option is secure. Tools installed in this location can be executed directly, so using an untrusted or shared path might introduce security risks. @@ -80,7 +80,7 @@ Tools with explicit tool paths are stored wherever you specified the `--tool-pat Local tools are stored in the NuGet global directory, whatever you've set that to be. There are shim files in `$HOME/.dotnet/toolResolverCache` for each local tool that point to where the tools are within that location. -References to local tools are added to a *dotnet-tools.json* file in a *.config* directory under the current directory. If a manifest file doesn't exist yet, create it by using the `--create-manifest-if-needed` option or by running the following command: +References to local tools are added to a *dotnet-tools.json* file in a *.config* directory under the current directory. Starting in .NET 10, if a manifest file doesn't exist yet, one is created automatically. You can also create one manually by running the following command: ```dotnetcli dotnet new tool-manifest @@ -112,19 +112,21 @@ For more information, see [Install a local tool](global-tools.md#install-a-local - **`--create-manifest-if-needed`** - Applies to local tools. Available starting with .NET 8 SDK. To find a manifest, the search algorithm searches up the directory tree for `dotnet-tools.json` or a `.config` folder that contains a `dotnet-tools.json` file. + Available starting in .NET 8 SDK. - If a tool-manifest can't be found and the `--create-manifest-if-needed` option is set to false, the `CannotFindAManifestFile` error occurs. + Applies to local tools. To find a manifest, the search algorithm searches up the directory tree for `dotnet-tools.json` or a `.config` folder that contains a `dotnet-tools.json` file. - If a tool-manifest can't be found and the `--create-manifest-if-needed` option is set to true, the tool creates a manifest automatically. It chooses a folder for the manifest as follows: + If a tool-manifest can't be found and the `--create-manifest-if-needed` option is set to `false`, the `CannotFindAManifestFile` error occurs. - * Walk up the directory tree searching for a directory that has a `.git` subfolder. If one is found, create the manifest in that directory. - * If the previous step doesn't find a directory, walk up the directory tree searching for a directory that has a `.sln` or `.git` file. If one is found, create the manifest in that directory. - * If neither of the previous two steps finds a directory, create the manifest in the current working directory. + If a tool-manifest can't be found and the `--create-manifest-if-needed` option is set to `true` (or, in .NET 10 and later versions, when not specified), the tool creates a manifest automatically. It chooses a folder for the manifest as follows: + + - Walk up the directory tree searching for a directory that has a `.git` subfolder. If one is found, create the manifest in that directory. + - If the previous step doesn't find a directory, walk up the directory tree searching for a directory that has a `.sln` or `.git` file. If one is found, create the manifest in that directory. + - If neither of the previous two steps finds a directory, create the manifest in the current working directory. For more information on how manifests are located, see [Install a local tool](global-tools.md#install-a-local-tool). - Starting in .NET 10, this flag is applied automatically if no tools manifest is found. + Starting in .NET 10, a manifest is created automatically if no tools manifest is found. This change can be a [breaking change](../compatibility/sdk/10.0/dotnet-tool-install-local-manifest.md). You can opt out by passing `--create-manifest-if-needed=false`. > [!WARNING] > Don't run tool commands from the **Downloads** folder or any shared location. The CLI walks up the directory tree to find a tool manifest, which might cause it to use a manifest you don't expect. Always run tool commands from a trusted, project-specific directory. diff --git a/docs/csharp/asynchronous-programming/start-multiple-async-tasks-and-process-them-as-they-complete.md b/docs/csharp/asynchronous-programming/start-multiple-async-tasks-and-process-them-as-they-complete.md index 848aeb96cd701..40189bba94946 100644 --- a/docs/csharp/asynchronous-programming/start-multiple-async-tasks-and-process-them-as-they-complete.md +++ b/docs/csharp/asynchronous-programming/start-multiple-async-tasks-and-process-them-as-they-complete.md @@ -169,6 +169,31 @@ Run the program several times to verify that the downloaded lengths don't always > [!CAUTION] > You can use `WhenAny` in a loop, as described in the example, to solve problems that involve a small number of tasks. However, other approaches are more efficient if you have a large number of tasks to process. For more information and examples, see [Processing tasks as they complete](https://devblogs.microsoft.com/pfxteam/processing-tasks-as-they-complete). +## Simplify the approach using `Task.WhenEach` + +The `while` loop implemented in `SumPageSizesAsync` method can be simplified using the new method introduced in .NET 9, by calling it in `await foreach` loop. +
Replace the previously implemented `while` loop: + +```csharp + while (downloadTasks.Any()) + { + Task finishedTask = await Task.WhenAny(downloadTasks); + downloadTasks.Remove(finishedTask); + total += await finishedTask; + } +``` + +with the simplified `await foreach`: + +```csharp + await foreach (Task t in Task.WhenEach(downloadTasks)) + { + total += await t; + } +``` + +This new approach allows to no longer repeatedly call `Task.WhenAny` to manually call a task and remove the one that finishes, because `Task.WhenEach` iterates through task *in an order of their completion*. + ## Complete example The following code is the complete text of the *Program.cs* file for the example. @@ -178,4 +203,5 @@ The following code is the complete text of the *Program.cs* file for the example ## See also - +- - [Asynchronous programming with async and await (C#)](index.md) diff --git a/docs/framework/release-notes/2025/09-09-september-cumulative-update.md b/docs/framework/release-notes/2025/09-09-september-cumulative-update.md new file mode 100644 index 0000000000000..03bf621d39d73 --- /dev/null +++ b/docs/framework/release-notes/2025/09-09-september-cumulative-update.md @@ -0,0 +1,84 @@ +--- +title: September 2025 security and quality rollup +description: Learn about the improvements in the .NET Framework September 2025 security and quality rollup. +ms.date: 09/09/2025 +--- +# September 2025 security and quality rollup + +_Released September 9, 2025_ + +## Summary of what's new in this release + +- [Security improvements](#security-improvements) +- [Quality and reliability improvements](#quality-and-reliability-improvements) + +### Security improvements + +There are no new security improvements in this release. This update is cumulative and contains all previously released security improvements. + +### Quality and reliability improvements + +This release contains the following quality and reliability improvements. + +#### ASP.NET + +Addressed an issue in ASP.NET where some error events fail to log properly in the Windows Event log. (*Applies to: .NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1.*) + +#### WPF + +Addressed an update for GB18030 certificate for Chinese language changes. (*Applies to: .NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1.*) + +## Known issues + +This release contains no known issues. + +## Summary tables + +| Product version | Cumulative update | +| --- | --- | +| **Windows 11, version 24H2** | | +| .NET Framework 3.5, 4.8.1 | [5064401](https://support.microsoft.com/kb/5064401) | +| **Microsoft server operating system, version 24H2** | | +| .NET Framework 3.5, 4.8.1 | [5064401](https://support.microsoft.com/kb/5064401) | +| **Microsoft server operating system, version 23H2** | | +| .NET Framework 3.5, 4.8.1 | [5065756](https://support.microsoft.com/kb/5065756) | +| **Windows 11, version 22H2 and Windows 11, version 23H2** | | +| .NET Framework 3.5, 4.8.1 | [5064403](https://support.microsoft.com/kb/5064403) | +| **Microsoft server operating system, version 22H2** | **[5065962](https://support.microsoft.com/kb/5065962)** | +| .NET Framework 3.5, 4.8 | [5065748](https://support.microsoft.com/kb/5065748) | +| .NET Framework 3.5, 4.8.1 | [5065753](https://support.microsoft.com/kb/5065753) | +| **Microsoft server operating system, version 21H2** | **[5065962](https://support.microsoft.com/kb/5065962)** | +| .NET Framework 3.5, 4.8 | [5065748](https://support.microsoft.com/kb/5065748) | +| .NET Framework 3.5, 4.8.1 | [5065753](https://support.microsoft.com/kb/5065753) | +| **Windows 10, version 22H2** | **[5065956](https://support.microsoft.com/kb/5065956)** | +| .NET Framework 3.5, 4.8 | [5064399](https://support.microsoft.com/kb/5064399) | +| .NET Framework 3.5, 4.8.1 | [5064400](https://support.microsoft.com/kb/5064400) | +| **Windows 10, version 21H2** | **[5065956](https://support.microsoft.com/kb/5065956)** | +| .NET Framework 3.5, 4.8 | [5064399](https://support.microsoft.com/kb/5064399) | +| .NET Framework 3.5, 4.8.1 | [5064400](https://support.microsoft.com/kb/5064400) | +| **Windows 10 1809 and Windows Server 2019** | **[5065955](https://support.microsoft.com/kb/5065955)** | +| .NET Framework 3.5, 4.7.2 | [5065744](https://support.microsoft.com/kb/5065744) | +| .NET Framework 3.5, 4.8 | [5065755](https://support.microsoft.com/kb/5065755) | + +The following table is for earlier Windows and Windows Server versions for Security and Quality Rollup updates.   + +| Product version | Security and quality rollup | +| --- | --- | +| **Windows Server 2012 R2** | **[5065960](https://support.microsoft.com/kb/5065960)** | +| .NET Framework 3.5 | [5044012](https://support.microsoft.com/kb/5044012) | +| .NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2 | [5065747](https://support.microsoft.com/kb/5065747) | +| .NET Framework 4.8 | [5065752](https://support.microsoft.com/kb/5065752) | +| **Windows Server 2012** | **[5065959](https://support.microsoft.com/kb/5065959)** | +| .NET Framework 3.5 | [5044009](https://support.microsoft.com/kb/5044009) | +| .NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2 | [5065746](https://support.microsoft.com/kb/5065746)| +| .NET Framework 4.8 | [5065751](https://support.microsoft.com/kb/5065751) | +| **Windows Server 2008 R2** | **[5065958](https://support.microsoft.com/kb/5065958)** | +| .NET Framework 3.5.1 | [5044011](https://support.microsoft/kb/5044011) | +| .NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2 | [5065745](https://support.microsoft.com/kb/5065745) | +| .NET Framework 4.8 | [5065750](https://support.microsoft.com/kb/5065750) | +| **Windows Server 2008** | **[5065961](https://support.microsoft.com/kb/5065961)**| +| .NET Framework 2.0, 3.0 | [5044010](https://support.microsoft.com/kb/5044010) | +| .NET Framework 3.5 SP1 | [5040673](https://support.microsoft.com/kb/5040673) | +| .NET Framework 4.6.2 | [5065745](https://support.microsoft.com/kb/5065745) | + +The operating system row lists a KB that is used for update offering purposes. When the operating system KB is offered, the applicability logic determines the specific .NET Framework updates to install. Updates for individual .NET Framework versions are installed based on the version of .NET Framework that's already present on the device. Because of this, the operating system KB isn't expected to be listed as **installed updates** on the device. The expected updates to be installed are the .NET Framework-specific version updates listed in the table above. diff --git a/docs/framework/release-notes/release-notes.md b/docs/framework/release-notes/release-notes.md index 605ba23595532..dfc6adb9b8d41 100644 --- a/docs/framework/release-notes/release-notes.md +++ b/docs/framework/release-notes/release-notes.md @@ -11,7 +11,8 @@ The .NET Framework updates include cumulative security and reliability improveme .NET Framework cumulative update releases are discussed in detail in the following individual release notes: -* August 26, 2025 - [cumulative update preview](./2025/08-26-august-cumulative-update-preview.md) **New Release** +* September 9, 2025 - [cumulative update](./2025/09-09-september-cumulative-update.md) **New Release** +* August 26, 2025 - [cumulative update preview](./2025/08-26-august-cumulative-update-preview.md) * July 8, 2025 - [cumulative update](./2025/07-08-july-cumulative-update.md) * April 22, 2025 - [cumulative update preview](./2025/04-22-april-cumulative-update-preview.md) * April 8, 2025 - [cumulative update](./2025/04-08-april-cumulative-update.md) diff --git a/docs/framework/toc.yml b/docs/framework/toc.yml index a405065e2ba44..d2607d4914e71 100644 --- a/docs/framework/toc.yml +++ b/docs/framework/toc.yml @@ -701,6 +701,8 @@ items: href: release-notes/2025/07-08-july-cumulative-update.md - name: August 2025 cumulative update href: release-notes/2025/08-26-august-cumulative-update-preview.md + - name: September 2025 cumulative update + href: release-notes/2025/09-09-september-cumulative-update.md - name: What's new href: whats-new/index.md - name: What's new in accessibility diff --git a/docs/fundamentals/code-analysis/quality-rules/ca3076.md b/docs/fundamentals/code-analysis/quality-rules/ca3076.md index 694b7dd2da321..3b5f05f4eac93 100644 --- a/docs/fundamentals/code-analysis/quality-rules/ca3076.md +++ b/docs/fundamentals/code-analysis/quality-rules/ca3076.md @@ -17,18 +17,17 @@ f1_keywords: ## Cause -If you execute Extensible Stylesheets Language Transformations (XSLT) in .NET applications insecurely, the processor may resolve untrusted URI references that could disclose sensitive information to attackers, leading to Denial of Service and Cross-Site attacks. For more information, see [XSLT Security Considerations(.NET Guide)](../../../standard/data/xml/xslt-security-considerations.md). +If you execute Extensible Stylesheets Language Transformations (XSLT) in .NET applications insecurely, the processor might resolve untrusted URI references that could disclose sensitive information to attackers, leading to denial of service and cross-site attacks. For more information, see [XSLT Security Considerations (.NET Guide)](../../../standard/data/xml/xslt-security-considerations.md). ## Rule description -**XSLT** is a World Wide Web Consortium (W3C) standard for transforming XML data. XSLT is typically used to write style sheets to transform XML data to other formats such as HTML, fixed-length text, comma-separated text, or a different XML format. Although prohibited by default, you may choose to enable it for your project. +*XSLT* is a World Wide Web Consortium (W3C) standard for transforming XML data. XSLT is typically used to write style sheets to transform XML data to other formats such as HTML, fixed-length text, comma-separated text, or a different XML format. Although prohibited by default, you might choose to enable it for your project. To ensure you're not exposing an attack surface, this rule triggers whenever the XslCompiledTransform. receives insecure combination instances of and , which allows malicious script processing. ## How to fix violations -- Replace the insecure XsltSettings argument with XsltSettings. or with an instance that has disabled document function and script execution. - +- Replace the insecure `XsltSettings` argument with or with an instance that's disabled document function and script execution. - Replace the argument with null or an instance. ## When to suppress warnings @@ -150,6 +149,9 @@ namespace TestNamespace } ``` +> [!NOTE] +> Starting in .NET 10, the property is marked as obsolete and generates warning `SYSLIB0062`. On .NET (Core), it's no longer necessary to explicitly set this property to `false` since script execution isn't supported. + ## See also -- [XSLT Security Considerations(.NET Guide)](../../../standard/data/xml/xslt-security-considerations.md) +- [XSLT Security Considerations (.NET Guide)](../../../standard/data/xml/xslt-security-considerations.md) diff --git a/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md b/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md index 43e95dab5bb67..f6a8f835fbe53 100644 --- a/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md +++ b/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md @@ -82,6 +82,7 @@ The following table provides an index to the `SYSLIB0XXX` obsoletions in .NET 5+ | [SYSLIB0059](syslib0059.md) | Warning | callbacks aren't run before the process exits. Use instead. | | [SYSLIB0060](syslib0060.md) | Warning | Constructors on are obsolete. Use instead. | | [SYSLIB0061](syslib0061.md) | Warning | The `Queryable` and taking an `IComparer` are obsolete. Use the new ones that take an `IComparer`. | +| [SYSLIB0062](syslib0062.md) | Warning | is obsolete. | ## Suppress warnings diff --git a/docs/fundamentals/syslib-diagnostics/syslib0061.md b/docs/fundamentals/syslib-diagnostics/syslib0061.md index 6d35bf5e93396..06c3b3889a7a6 100644 --- a/docs/fundamentals/syslib-diagnostics/syslib0061.md +++ b/docs/fundamentals/syslib-diagnostics/syslib0061.md @@ -5,7 +5,7 @@ ms.date: 03/31/2025 f1_keywords: - SYSLIB0061 --- -# SYSLIB0061: System.Linq.Queryable.MaxBy and System.Linq.Queryable.MinBy taking an IComparer\ are obsolete. +# SYSLIB0061: System.Linq.Queryable.MaxBy and System.Linq.Queryable.MinBy taking an IComparer\ are obsolete Starting in .NET 10, the two extension methods and that accept an `IComparer` are obsolete. Please use the newly added overloads that accept an `IComparer` instead. diff --git a/docs/fundamentals/syslib-diagnostics/syslib0062.md b/docs/fundamentals/syslib-diagnostics/syslib0062.md new file mode 100644 index 0000000000000..cd86fc86946bc --- /dev/null +++ b/docs/fundamentals/syslib-diagnostics/syslib0062.md @@ -0,0 +1,48 @@ +--- +title: SYSLIB0062 warning - XsltSettings.EnableScript is obsolete +description: Learn about the obsoletion of the XsltSettings.EnableScript property. Use of this property generates compile-time warning SYSLIB0062. +ms.date: 09/08/2025 +f1_keywords: + - SYSLIB0062 +--- +# SYSLIB0062: XsltSettings.EnableScript is obsolete + +Starting in .NET 10, the property is marked obsolete. + +## Reason for obsoletion + +XSLT script blocks aren't supported on .NET (Core). Previously, if you set the property to `true`, a was thrown at run time. This obsoletion turns a run-time error into a build warning, which provides better guidance for migration. + +## Workaround + +Review call sites for any assumptions made about the behavior of this property. You can likely remove any references to the property since it didn't truly enable script blocks on modern .NET. + +## Suppress a warning + +If you must use the obsolete API, you can suppress the warning in code or in your project file. + +To suppress only a single violation, add preprocessor directives to your source file to disable and then re-enable the warning. + +```csharp +// Disable the warning. +#pragma warning disable SYSLIB0062 + +// Code that uses obsolete API. +// ... + +// Re-enable the warning. +#pragma warning restore SYSLIB0062 +``` + +To suppress all the `SYSLIB0062` warnings in your project, add a `` property to your project file. + +```xml + + + ... + $(NoWarn);SYSLIB0062 + + +``` + +For more information, see [Suppress warnings](obsoletions-overview.md#suppress-warnings). diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index 2220f172b118a..52b37667a3956 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -4022,6 +4022,8 @@ items: href: ../../fundamentals/syslib-diagnostics/syslib0060.md - name: SYSLIB0061 href: ../../fundamentals/syslib-diagnostics/syslib0061.md + - name: SYSLIB0062 + href: ../../fundamentals/syslib-diagnostics/syslib0062.md - name: Experimental features items: - name: Overview diff --git a/docs/standard/data/xml/script-blocks-using-msxsl-script.md b/docs/standard/data/xml/script-blocks-using-msxsl-script.md index ffe21e97d91ad..37a862edff588 100644 --- a/docs/standard/data/xml/script-blocks-using-msxsl-script.md +++ b/docs/standard/data/xml/script-blocks-using-msxsl-script.md @@ -7,21 +7,24 @@ dev_langs: - "vb" ms.assetid: fde6f43f-c594-486f-abcb-2211197fae20 --- -# Script Blocks Using msxsl:script +# Script blocks Using msxsl:script > [!NOTE] > Script blocks are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later. The class supports embedded scripts using the `msxsl:script` element. When the style sheet is loaded, any defined functions are compiled to common intermediate language (CIL) by the Code Document Object Model (CodeDOM) and are executed during run time. The assembly generated from the embedded script block is separate than the assembly generated for the style sheet. -## Enable XSLT Script +## Enable XSLT script - Support for embedded scripts is an optional XSLT setting on the class. Script support is disabled by default. To enable script support, create an object with the property set to `true` and pass the object to the method. +Support for embedded scripts is an optional XSLT setting on the class. Script support is disabled by default. To enable script support, create an object with the property set to `true` and pass the object to the method. + +> [!WARNING] +> Starting in .NET 10, the property is marked as obsolete and generates warning SYSLIB0062. Since script blocks aren't supported on .NET Core or .NET 5+, this property has no effect and setting it to `true` throws a at run time. > [!NOTE] > XSLT scripting should be enabled only if you require script support and you are working in a fully trusted environment. -## msxsl:script Element Definition +## msxsl:script element definition The `msxsl:script` element is a Microsoft extension to the XSLT 1.0 recommendation and has the following definition: @@ -46,25 +49,25 @@ The class supports embedded scripts u ``` -## Script Functions +## Script functions Functions can be declared within the `msxsl:script` element. When a function is declared, it is contained in a script block. Style sheets can contain multiple script blocks, each operating independent of the other. That means that if you are executing inside a script block, you cannot call a function that you defined in another script block unless it is declared to have the same namespace and the same scripting language. Because each script block can be in its own language, and the block is parsed according to the grammar rules of that language parser we recommend that you use the correct syntax for the language in use. For example, if you are in a Microsoft C# script block, use the C# comment syntax. The supplied arguments and return values to the function can be of any type. Because the W3C XPath types are a subset of the common language runtime (CLR) types, type conversion takes place on types that are not considered to be an XPath type. The following table shows the corresponding W3C types and the equivalent CLR type. -|W3C type|CLR type| -|--------------|--------------| -|`String`|| -|`Boolean`|| -|`Number`|| -|`Result Tree Fragment`|| -|`Node Set`|| +| W3C type | CLR type | +|------------------------|-------------------------------------------| +| `String` | | +| `Boolean` | | +| `Number` | | +| `Result Tree Fragment` | | +| `Node Set` | | CLR numeric types are converted to . The type is converted to . types are converted to . **XPathNavigator[]** is converted to . All other types throw an error. -### Importing Namespaces and Assemblies +### Import namespaces and assemblies The class predefines a set of assemblies and namespaces that are supported by default by the `msxsl:script` element. However, you can use classes and members belonging to a namespace that is not on the predefined list by importing the assembly and namespace in `msxsl:script` block. @@ -73,9 +76,7 @@ The class supports embedded scripts u The following two assemblies are referenced by default: - System.dll - - System.Xml.dll - - Microsoft.VisualBasic.dll (when the script language is VB) You can import the additional assemblies using the `msxsl:assembly` element. This includes the assembly when the style sheet is compiled. The `msxsl:assembly` element has the following definition: @@ -97,19 +98,12 @@ The class supports embedded scripts u The following namespaces are included by default: - System - - System.Collection - - System.Text - - System.Text.RegularExpressions - - System.Xml - - System.Xml.Xsl - - System.Xml.XPath - - Microsoft.VisualBasic (when the script language is VB) You can add support for additional namespaces using the `namespace` attribute. The attribute value is the name of the namespace. diff --git a/docs/visual-basic/language-reference/statements/addhandler-statement.md b/docs/visual-basic/language-reference/statements/addhandler-statement.md index 41d1bc97fede6..5972d20b0deda 100644 --- a/docs/visual-basic/language-reference/statements/addhandler-statement.md +++ b/docs/visual-basic/language-reference/statements/addhandler-statement.md @@ -45,7 +45,16 @@ The parts `AddressOf eventhandler` and `expression` are mutually exclusive. ## Example - [!code-vb[VbVbalrEvents#17](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb#17)] +The following example demonstrates how to use `AddHandler` with `ConvertEventHandler` delegates for data binding scenarios. This example shows a practical use case where event handlers are attached to `Format` and `Parse` events of a `Binding` object to convert between decimal values and currency strings. + +[!code-vb[VbVbalrEvents#17](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb#17)] + +This example shows: + +- Creating a `Binding` object for data binding. +- Using `AddHandler` to attach `ConvertEventHandler` delegates to the `Format` and `Parse` events. +- Implementing event handler methods that convert between decimal and currency string formats. +- Basic `AddHandler` usage with custom events and lambda expressions. ## See also diff --git a/docs/visual-basic/language-reference/statements/property-statement.md b/docs/visual-basic/language-reference/statements/property-statement.md index 43fb00a482822..afdfe6267a6f4 100644 --- a/docs/visual-basic/language-reference/statements/property-statement.md +++ b/docs/visual-basic/language-reference/statements/property-statement.md @@ -44,7 +44,7 @@ Property name ( [ parameterlist ] ) [ As returntype ] [ Implements implementslis - `Default` - Optional. Specifies that this property is the default property for the class or structure on which it is defined. Default properties must accept parameters and can be set and retrieved without specifying the property name. If you declare the property as `Default`, you cannot use `Private` on the property or on either of its property procedures. + Optional. Specifies that this property is the default property for the class or structure on which it is defined. Default properties must accept parameters and can be set and retrieved without specifying the property name. If you declare the property as `Default`, you cannot use `Private` on the property or on either of its property procedures. For examples and detailed guidance, see [How to: Declare and Call a Default Property in Visual Basic](../../programming-guide/language-features/procedures/how-to-declare-and-call-a-default-property.md). - `accessmodifier` @@ -108,7 +108,7 @@ Property name ( [ parameterlist ] ) [ As returntype ] [ Implements implementslis - `parameterlist` - Optional. List of local variable names representing the parameters of this property, and possible additional parameters of the `Set` procedure. See [Parameter List](parameter-list.md). + Optional. List of local variable names representing the parameters of this property, and possible additional parameters of the `Set` procedure. Parameterized properties are often used to create indexers or default properties that allow collection-like access. See [Parameter List](parameter-list.md) and [How to: Declare and Call a Default Property in Visual Basic](../../programming-guide/language-features/procedures/how-to-declare-and-call-a-default-property.md). - `returntype` @@ -163,7 +163,7 @@ The `Property` statement introduces the declaration of a property. A property ca You can use `Property` only at class level. This means the *declaration context* for a property must be a class, structure, module, or interface, and cannot be a source file, namespace, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). -By default, properties use public access. You can adjust a property's access level with an access modifier on the `Property` statement, and you can optionally adjust one of its property procedures to a more restrictive access level. +By default, properties use public access. You can adjust a property's access level with an access modifier on the `Property` statement, and you can optionally adjust one of its property procedures to a more restrictive access level. For detailed examples of mixed access levels, see [How to: Declare a Property with Mixed Access Levels](../../programming-guide/language-features/procedures/how-to-declare-a-property-with-mixed-access-levels.md). Visual Basic passes a parameter to the `Set` procedure during property assignments. If you do not supply a parameter for `Set`, the integrated development environment (IDE) uses an implicit parameter named `value`. This parameter holds the value to be assigned to the property. You typically store this value in a private local variable and return it whenever the `Get` procedure is called. @@ -205,11 +205,31 @@ The following example declares a property in a class. [!code-vb[VbVbalrStatements#51](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb#51)] +### Parameterized Properties + +The following example shows how to create a parameterized property, also called an indexer, which allows array-like access to a collection: + +[!code-vb[VbVbalrStatements#52](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb#52)] + +For comprehensive examples of property usage, including automatic implementation, mixed access levels, and validation scenarios, see [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md). + ## See also +### Property Types and Features + - [Automatically implemented properties](../../programming-guide/language-features/procedures/auto-implemented-properties.md) -- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) +- [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md) +- [How to: Create a Property](../../programming-guide/language-features/procedures/how-to-create-a-property.md) + +### Advanced Property Scenarios + +- [How to: Declare and Call a Default Property in Visual Basic](../../programming-guide/language-features/procedures/how-to-declare-and-call-a-default-property.md) +- [How to: Declare a Property with Mixed Access Levels](../../programming-guide/language-features/procedures/how-to-declare-a-property-with-mixed-access-levels.md) + +### Related Statements and Concepts + - [Get Statement](get-statement.md) - [Set Statement](set-statement.md) - [Parameter List](parameter-list.md) - [Default](../modifiers/default.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/index.md b/docs/visual-basic/language-reference/xmldoc/index.md index a5d42e130cf2d..b574812f86f04 100644 --- a/docs/visual-basic/language-reference/xmldoc/index.md +++ b/docs/visual-basic/language-reference/xmldoc/index.md @@ -37,6 +37,7 @@ The Visual Basic compiler can process documentation comments in your code to an - [\](seealso.md) 1 - [\](summary.md) - [\](typeparam.md) 1 +- [\](typeparamref.md) - [\](value.md) (1 The compiler verifies syntax.) diff --git a/docs/visual-basic/language-reference/xmldoc/typeparamref.md b/docs/visual-basic/language-reference/xmldoc/typeparamref.md new file mode 100644 index 0000000000000..a85dae50fe407 --- /dev/null +++ b/docs/visual-basic/language-reference/xmldoc/typeparamref.md @@ -0,0 +1,38 @@ +--- +description: "Learn more about: (Visual Basic)" +title: "" +ms.date: 09/10/2025 +helpviewer_keywords: + - "typeparamref XML tag" + - " XML tag" +ai-usage: ai-assisted +--- +# \ (Visual Basic) + +Formats a word as a type parameter. + +## Syntax + +```xml + +``` + +## Parameters + + `name`: The name of the type parameter to refer to. Enclose the name in double quotation marks (" "). + +## Remarks + + The `` tag gives you a way to indicate that a word is a type parameter. The XML file can be processed to format this type parameter in some distinct way, for example in italics. + + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. + +## Example + +This example uses the `` tag to refer to the `T` type parameter. + +:::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/Class1.vb" id="snippet9"::: + +## See also + +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/toc.yml b/docs/visual-basic/toc.yml index 0e749ebb57c55..e01dd8e0f0196 100644 --- a/docs/visual-basic/toc.yml +++ b/docs/visual-basic/toc.yml @@ -852,6 +852,8 @@ items: href: language-reference/xmldoc/summary.md - name: href: language-reference/xmldoc/typeparam.md + - name: + href: language-reference/xmldoc/typeparamref.md - name: href: language-reference/xmldoc/value.md - name: XML Axis Properties @@ -889,363 +891,363 @@ items: href: language-reference/error-messages/attribute-attributename-cannot-be-applied-multiple-times.md - name: BC32500 href: language-reference/error-messages/attribute-cannot-be-applied-because-the-format-of-the-guid-is-not-correct.md - - name: "'#ElseIf' must be preceded by a matching '#If' or '#ElseIf'" + - name: BC30014 href: language-reference/error-messages/elseif-must-be-preceded-by-a-matching-if-or-elseif.md - - name: "'#Region' and '#End Region' statements are not valid within method bodies-multiline lambdas" + - name: BC32025 href: language-reference/error-messages/region-and-end-region-are-not-valid-within-method-bodies-multiline-lambdas.md - - name: "'' is not CLS-compliant because the interface '' it implements is not CLS-compliant" + - name: BC40029 href: language-reference/error-messages/classname-is-not-cls-compliant-because-the-interface-is-not-cls-compliant.md - - name: "'' is obsolete (Visual Basic Warning)" + - name: BC40008 href: language-reference/error-messages/elementname-is-obsolete-visual-basic-warning.md - - name: "'' is an event, and cannot be called directly" + - name: BC32022 href: language-reference/error-messages/eventname-is-an-event-and-cannot-be-called-directly.md - - name: "'' cannot be used as a type constraint" + - name: BC32061 href: language-reference/error-messages/expression-cannot-be-used-as-a-type-constraint.md - - name: "'' is not declared (Smart Device-Visual Basic Compiler Error)" + - name: BC30766 href: language-reference/error-messages/functionname-is-not-declared-smart-device-visual-basic-compiler-error.md - - name: "'.' is already implemented by the base class ''. Re-implementation of assumed" + - name: BC42015 href: language-reference/error-messages/interfacename-membername-is-already-implemented-by-the-base-class.md - - name: "'' is valid only within an instance method" + - name: BC30043 href: language-reference/error-messages/keyword-is-valid-only-within-an-instance-method.md - - name: "'' cannot expose type '' outside the project through ''" + - name: BC30909 href: language-reference/error-messages/membername-cannot-expose-type-typename-outside-the-project.md - - name: "'' is ambiguous across the inherited interfaces '' and ''" + - name: BC30685 href: language-reference/error-messages/membername-is-ambiguous-across-the-inherited-interfaces.md - - name: This error could also be due to mixing a file reference with a project reference to assembly '' + - name: BC30971 href: language-reference/error-messages/message-this-error-could-also-be-due-to-mixing-a-file-reference.md - - name: "'' has multiple definitions with identical signatures" + - name: BC30269 href: language-reference/error-messages/methodname-has-multiple-definitions-with-identical-signatures.md - - name: "'' is ambiguous in the namespace ''" + - name: BC30560 href: language-reference/error-messages/name-is-ambiguous-in-the-namespace-namespacename.md - - name: "'' is ambiguous, imported from the namespaces or types ''" + - name: BC30561 href: language-reference/error-messages/name1-is-ambiguous-imported-from-the-namespaces-or-types-name2.md - - name: is not CLS-compliant because it overloads which differs from it only by array of array parameter types or by the rank of the array parameter types + - name: BC40035 href: language-reference/error-messages/proceduresignature1-not-cls-compliant-because-it-overloads-proceduresignature2.md - - name: '' must implement '' for interface '' + - name: BC30154 href: language-reference/error-messages/type1-must-implement-membername-for-interface.md - - name: '' must implement '' for interface '' + - name: BC30149 href: language-reference/error-messages/type1-typename-must-implement-methodname-for-interface-interfacename.md - - name: "'' cannot inherit from '' because it expands the access of the base outside the assembly" + - name: BC30910 href: language-reference/error-messages/typename-cannot-inherit-from-type-basetypename.md - - name: "'' is a delegate type" + - name: BC32008 href: language-reference/error-messages/typename-is-a-delegate-type.md - - name: "'' is a type and cannot be used as an expression" + - name: BC30108 href: language-reference/error-messages/typename-is-a-type-and-cannot-be-used-as-an-expression.md - - name: A double quote is not a valid comment token for delimited fields where EscapeQuote is set to True + - name: TextFieldParser Error href: language-reference/error-messages/a-double-quote-is-not-a-valid-comment-token-for-delimited-fields.md - - name: A property or method call cannot include a reference to a private object, either as an argument or as a return value + - name: Runtime Error 98 href: language-reference/error-messages/a-property-or-method-call-cannot-include-a-reference-to-a-private-object.md - - name: A reference was created to embedded interop assembly '' because of an indirect reference to that assembly from assembly '' + - name: BC40059 href: language-reference/error-messages/bc40059.md - - name: A startup form has not been specified + - name: Application startup error href: language-reference/error-messages/a-startup-form-has-not-been-specified.md - - name: Access of shared member through an instance; qualifying expression will not be evaluated + - name: BC42025 href: language-reference/error-messages/bc42025.md - - name: "'AddressOf' operand must be the name of a method (without parentheses)" + - name: BC30577 href: language-reference/error-messages/bc30577.md - - name: An unexpected error has occurred because an operating system resource required for single instance startup cannot be acquired + - name: Unexpected application startup error href: language-reference/error-messages/an-unexpected-error-has-occurred.md - - name: Anonymous type member name can be inferred only from a simple or qualified name with no arguments + - name: BC36556 href: language-reference/error-messages/bc36556.md - - name: Argument not optional + - name: Runtime error 449 href: language-reference/error-messages/argument-not-optional.md - - name: Array bounds cannot appear in type specifiers + - name: BC30638 href: language-reference/error-messages/bc30638.md - - name: Array declared as for loop control variable cannot be declared with an initial size + - name: BC32039 href: language-reference/error-messages/bc32039.md - - name: Array subscript expression missing + - name: BC30306 href: language-reference/error-messages/bc30306.md - - name: Arrays declared as structure members cannot be declared with an initial size + - name: BC31043 href: language-reference/error-messages/bc31043.md - - name: "'As Any' is not supported in 'Declare' statements" + - name: BC30828 href: language-reference/error-messages/bc30828.md - - name: Automation error + - name: Runtime error 440 href: language-reference/error-messages/automation-error.md - - name: Bad checksum value, non hex digits or odd number of hex digits + - name: BC42033 href: language-reference/error-messages/bad-checksum-value-non-hex-digits-or-odd-number-of-hex-digits.md - - name: Bad DLL calling convention + - name: Runtime Error 49 href: language-reference/error-messages/bad-dll-calling-convention.md - - name: Bad file mode + - name: Runtime Error 54 href: language-reference/error-messages/bad-file-mode.md - - name: Bad file name or number + - name: Runtime Error 52 href: language-reference/error-messages/bad-file-name-or-number.md - - name: Bad record length + - name: Runtime Error 59 href: language-reference/error-messages/bad-record-length.md - - name: Because this call is not awaited, execution of the current method continues before the call is completed + - name: BC42358 href: language-reference/error-messages/bc42358.md - - name: Cannot convert anonymous type to an expression tree because a property of the type is used to initialize another property + - name: BC36548 href: language-reference/error-messages/bc36548.md - - name: Cannot create ActiveX Component + - name: Runtime Error 429 href: language-reference/error-messages/cannot-create-activex-component.md - - name: Cannot refer to '' because it is a member of the value-typed field '' of class '' which has 'System.MarshalByRefObject' as a base class + - name: BC30310 href: language-reference/error-messages/bc30310.md - - name: Cannot refer to an instance member of a class from within a shared method or shared member initializer without an explicit instance of the class + - name: BC30369 href: language-reference/error-messages/bc30369.md - - name: Can't create necessary temporary file + - name: Runtime Error 322 href: language-reference/error-messages/can-t-create-necessary-temporary-file.md - - name: Can't open '' for writing + - name: BC2012 href: language-reference/error-messages/bc2012.md - - name: Class '' cannot be found + - name: BC31098 href: language-reference/error-messages/bc31098.md - - name: Class does not support Automation or does not support expected interface + - name: Runtime Error 438 href: language-reference/error-messages/class-does-not-support-automation-or-does-not-support-expected-interface.md - - name: "'Class' statement must end with a matching 'End Class'" + - name: BC30481 href: language-reference/error-messages/class-statement-must-end-with-a-matching-end-class.md - - name: Clipboard format is not valid + - name: Runtime Error 460 href: language-reference/error-messages/clipboard-format-is-not-valid.md - - name: Constant expression not representable in type '' + - name: BC30439 href: language-reference/error-messages/constant-expression-not-representable-in-type-typename.md - - name: Constants must be of an intrinsic or enumerated type, not a class, structure, type parameter, or array type + - name: BC30424 href: language-reference/error-messages/constants-must-be-of-an-intrinsic-or-enumerated-type.md - - name: Constructor '' cannot call itself + - name: BC30298 href: language-reference/error-messages/constructor-name-cannot-call-itself.md - - name: Copying the value of 'ByRef' parameter '' back to the matching argument narrows from type '' to type '' + - name: BC32053 href: language-reference/error-messages/copying-the-value-of-byref-parameter-back-to-the-matching-argument-narrows.md - - name: "'Custom' modifier is not valid on events declared without explicit delegate types" + - name: BC31122 href: language-reference/error-messages/custom-modifier-is-not-valid-on-events-declared-without-explicit-delegate-types.md - - name: Data type(s) of the type parameter(s) cannot be inferred from these arguments + - name: BC36647 href: language-reference/error-messages/data-type-s-of-the-type-parameter-s-cannot-be-inferred-from-these-arguments.md - - name: Declaration expected + - name: BC30188 href: language-reference/error-messages/declaration-expected.md - - name: Default property '' conflicts with default property '' in '' and so should be declared 'Shadows' + - name: BC40007 href: language-reference/error-messages/default-property-propertyname1-conflicts-with-default-property-propertyname2.md - - name: Default property access is ambiguous between the inherited interface members '' of interface '' and '' of interface '' + - name: BC30686 href: language-reference/error-messages/default-property-access-is-ambiguous.md - - name: Delegate class '' has no Invoke method, so an expression of this type cannot be the target of a method call + - name: BC30220 href: language-reference/error-messages/delegate-class-classname-has-no-invoke-method.md - - name: Derived classes cannot raise base class events + - name: BC30029 href: language-reference/error-messages/derived-classes-cannot-raise-base-class-events.md - - name: Device I/O error + - name: Runtime Error 57 href: language-reference/error-messages/device-i-o-error.md - - name: "'Dir' function must first be called with a 'PathName' argument" + - name: Runtime Error 68 href: language-reference/error-messages/dir-function-must-first-be-called-with-a-pathname-argument.md - - name: End of statement expected + - name: BC30205 href: language-reference/error-messages/end-of-statement-expected.md - - name: "Error creating assembly manifest: " + - name: BC30140 href: language-reference/error-messages/error-creating-assembly-manifest-error-message.md - - name: "Error creating Win32 resources: " + - name: BC30136 href: language-reference/error-messages/error-creating-win32-resources-error-message.md - - name: Error in loading DLL + - name: Runtime Error 48 href: language-reference/error-messages/error-in-loading-dll.md - name: "Error saving temporary Win32 resource file '': " href: language-reference/error-messages/error-saving-temporary-win32-resource-file-filename-error-message.md - - name: Errors occurred while compiling the XML schemas in the project + - name: BC36810 href: language-reference/error-messages/errors-occurred-while-compiling-the-xml-schemas-in-the-project.md - - name: Evaluation of expression or statement timed out + - name: BC30722 href: language-reference/error-messages/evaluation-of-expression-or-statement-timed-out.md - - name: Event '' cannot implement event '' on interface '' because their delegate types '' and '' do not match + - name: BC31423 href: language-reference/error-messages/event-eventname1-cannot-implement-event-eventname2-on-interface.md - - name: Events cannot be declared with a delegate type that has a return type + - name: BC31084 href: language-reference/error-messages/events-cannot-be-declared-with-a-delegate-type-that-has-a-return-type.md - - name: Events of shared WithEvents variables cannot be handled by non-shared methods + - name: BC30594 href: language-reference/error-messages/events-of-shared-withevents-variables-cannot-be-handled-by-non-shared-methods.md - - name: Expression does not produce a value + - name: BC30491 href: language-reference/error-messages/expression-does-not-produce-a-value.md - - name: Expression has the type '' which is a restricted type and cannot be used to access members inherited from 'Object' or 'ValueType' + - name: BC31393 href: language-reference/error-messages/expression-has-the-type-typename-which-is-a-restricted-type.md - - name: Expression is a value and therefore cannot be the target of an assignment + - name: BC30068 href: language-reference/error-messages/expression-is-a-value-and-therefore-cannot-be-the-target-of-an-assignment.md - - name: Expression of type is not queryable + - name: BC36593 href: language-reference/error-messages/expression-of-type-type-is-not-queryable.md - - name: Expression recursively calls the containing property '' + - name: BC42026 href: language-reference/error-messages/expression-recursively-calls-the-containing-property-propertyname.md - - name: Expression too complex + - name: BC30494 href: language-reference/error-messages/expression-too-complex.md - name: "'Extension' attribute can be applied only to 'Module', 'Sub', or 'Function' declarations" href: language-reference/error-messages/extension-attribute-can-be-applied-only-to-module-sub-or-function-declarations.md - - name: File already open + - name: Runtime Error 55 href: language-reference/error-messages/file-already-open.md - - name: File is too large to read into a byte array + - name: File I/O error href: language-reference/error-messages/file-is-too-large-to-read-into-a-byte-array.md - - name: File name or class name not found during Automation operation + - name: Runtime Error 432 href: language-reference/error-messages/file-name-or-class-name-not-found-during-automation-operation.md - - name: File not found (Visual Basic Run-Time Error) + - name: Runtime Error 53 href: language-reference/error-messages/file-not-found-visual-basic-run-time-error.md - - name: First operand in a binary 'If' expression must be nullable or a reference type + - name: BC33107 href: language-reference/error-messages/first-operand-in-a-binary-if-expression-must-be-nullable-or-a-reference-type.md - - name: First statement of this 'Sub New' must be a call to 'MyBase.New' or 'MyClass.New' (No Accessible Constructor Without Parameters) + - name: BC30148 href: language-reference/error-messages/first-statement-of-this-sub-new-must-be-a-call-to-mybase-new-or-myclass-new.md - name: "First statement of this 'Sub New' must be an explicit call to 'MyBase.New' or 'MyClass.New' because the '' in the base class '' of '' is marked obsolete: ''" href: language-reference/error-messages/first-statement-of-sub-new-must-be-explicit-call-to-mybase-new-or-myclass-new.md - name: "'For Each' on type '' is ambiguous because the type implements multiple instantiations of 'System.Collections.Generic.IEnumerable(Of T)'" href: language-reference/error-messages/for-each-on-type-typename-is-ambiguous.md - - name: Friend assembly reference is invalid + - name: BC31535 href: language-reference/error-messages/friend-assembly-reference-reference-is-invalid.md - - name: Function '' doesn't return a value on all code paths + - name: BC42105 href: language-reference/error-messages/function-procedurename-doesn-t-return-a-value-on-all-code-paths.md - - name: Function evaluation is disabled because a previous function evaluation timed out + - name: BC30957 href: language-reference/error-messages/function-evaluation-is-disabled.md - - name: Generic parameters used as optional parameter types must be class constrained + - name: BC32124 href: language-reference/error-messages/generic-parameters-used-as-optional-parameter-types-must-be-class-constrained.md - name: "'Get' accessor of property '' is not accessible" href: language-reference/error-messages/get-accessor-of-property-propertyname-is-not-accessible.md - - name: Handles clause requires a WithEvents variable defined in the containing type or one of its base types + - name: BC30506 href: language-reference/error-messages/handles-clause-requires-a-withevents-variable-defined.md - - name: Identifier expected + - name: BC30203 href: language-reference/error-messages/identifier-expected.md - - name: Identifier is too long + - name: BC30033 href: language-reference/error-messages/identifier-is-too-long.md - - name: Initializer expected + - name: BC30996 href: language-reference/error-messages/initializer-expected.md - - name: Input past end of file + - name: Runtime Error 62 href: language-reference/error-messages/input-past-end-of-file.md - - name: Internal error happened at + - name: Runtime Error 51 href: language-reference/error-messages/internal-error-happened-at-location.md - - name: Implicit conversion from '' to '' in copying the value of 'ByRef' parameter '' back to the matching argument. + - name: BC41999 href: language-reference/error-messages/implicit-conversion-from-typename1-to-typename2-in-copying.md - name: "'Is' requires operands that have reference types, but this operand has the value type ''" href: language-reference/error-messages/is-requires-operands-that-have-reference-types.md - name: "'IsNot' operand of type 'typename' can only be compared to 'Nothing', because 'typename' is a nullable type" href: language-reference/error-messages/isnot-operand-of-type-can-only-be-compared-to-nothing.md - - name: Labels that are numbers must be followed by colons + - name: BC30801 href: language-reference/error-messages/labels-that-are-numbers-must-be-followed-by-colons.md - - name: Lambda expression will not be removed from this event handler + - name: BC42326 href: language-reference/error-messages/lambda-expression-will-not-be-removed-from-this-event-handler.md - - name: Lambda expressions are not valid in the first expression of a 'Select Case' statement + - name: BC36635 href: language-reference/error-messages/lambda-expressions-are-not-valid-in-the-first-expression-of-select-case.md - - name: Late bound resolution; runtime errors could occur + - name: BC42017 href: language-reference/error-messages/late-bound-resolution-runtime-errors-could-occur.md - - name: Latebound overload resolution cannot be applied to '' because the accessing instance is an interface type + - name: BC30933 href: language-reference/error-messages/latebound-overload-resolution-cannot-be-applied.md - - name: Leading '.' or '!' can only appear inside a 'With' statement + - name: BC30157 href: language-reference/error-messages/leading-period-or-exclamation-point-can-only-appear-inside-a-with-statement.md - - name: Line is too long + - name: BC30494 href: language-reference/error-messages/line-is-too-long.md - name: "'Line' statements are no longer supported (Visual Basic Compiler Error)" href: language-reference/error-messages/line-statements-are-no-longer-supported-visual-basic-compiler-error.md - - name: Method does not have a signature compatible with the delegate + - name: BC36563 href: language-reference/error-messages/method-does-not-have-a-signature-compatible-with-the-delegate.md - - name: Methods of 'System.Nullable(Of T)' cannot be used as operands of the 'AddressOf' operator + - name: BC32126 href: language-reference/error-messages/methods-of-system-nullable-of-t-cannot-be-used-as-operands-of-the-addressof.md - name: "'Module' statements can occur only at file or namespace level" href: language-reference/error-messages/module-statements-can-occur-only-at-file-or-namespace-level.md - - name: Name is not CLS-compliant + - name: BC40031 href: language-reference/error-messages/name-membername-is-not-cls-compliant.md - - name: Name '' is not declared + - name: BC30451 href: language-reference/error-messages/name-name-is-not-declared.md - - name: Name in the root namespace is not CLS-compliant + - name: BC40039 href: language-reference/error-messages/name-namespacename-in-the-root-namespace-fullnamespacename-is-not-cls-compliant.md - - name: Namespace or type specified in the Imports '' doesn't contain any public member or cannot be found + - name: BC40056 href: language-reference/error-messages/namespace-or-type-specified-in-the-imports-qualifiedelementname.md - - name: Namespace or type specified in the project-level Imports '' doesn't contain any public member or cannot be found + - name: BC40057 href: language-reference/error-messages/namespace-or-type-specified-in-the-project-level-imports-qualifiedelementname.md - - name: Need property array index + - name: Runtime Error 381 href: language-reference/error-messages/need-property-array-index.md - - name: Nested function does not have a signature that is compatible with delegate '' + - name: BC36532 href: language-reference/error-messages/nested-function-does-not-have-a-signature-that-is-compatible-with-delegate.md - - name: No accessible 'Main' method with an appropriate signature was found in '' + - name: BC30737 href: language-reference/error-messages/no-accessible-main-method-with-an-appropriate-signature-was-found-in-name.md - - name: Non-CLS-compliant is not allowed in a CLS-compliant interface + - name: BC40033 href: language-reference/error-messages/non-cls-compliant-membername-is-not-allowed-in-a-cls-compliant-interface.md - - name: Nullable type inference is not supported in this context + - name: BC36629 href: language-reference/error-messages/nullable-type-inference-is-not-supported-in-this-context.md - - name: Number of indices exceeds the number of dimensions of the indexed array + - name: BC30106 href: language-reference/error-messages/number-of-indices-exceeds-the-number-of-dimensions-of-the-indexed-array.md - - name: Object or class does not support the set of events + - name: Runtime Error 80 href: language-reference/error-messages/object-or-class-does-not-support-the-set-of-events.md - - name: Object required + - name: Runtime Error 424 href: language-reference/error-messages/object-required.md - - name: Object variable or With block variable not set + - name: Runtime Error 91 href: language-reference/error-messages/object-variable-or-with-block-variable-not-set.md - name: "Operator declaration must be one of: +,-,*,-,-,^, &, Like, Mod, And, Or, Xor, Not, <<, >>, =, <>, <, <=, >, >=, CType, IsTrue, IsFalse" href: language-reference/error-messages/operator-declaration-must-be-one-of.md - name: "'Optional' expected" href: language-reference/error-messages/optional-expected.md - - name: Optional parameters must specify a default value + - name: BC30812 href: language-reference/error-messages/optional-parameters-must-specify-a-default-value.md - - name: Ordinal is not valid + - name: Runtime Error 452 href: language-reference/error-messages/ordinal-is-not-valid.md - - name: Out of memory (Visual Basic Compiler Error) + - name: BC2004 href: language-reference/error-messages/out-of-memory-visual-basic-compiler-error.md - - name: Out of stack space + - name: Runtime Error 28 href: language-reference/error-messages/out-of-stack-space.md - - name: Out of string space + - name: Runtime Error 14 href: language-reference/error-messages/out-of-string-space.md - - name: Overflow (Visual Basic Error) + - name: BC30036 href: language-reference/error-messages/overflow-visual-basic-error.md - - name: Overflow (Visual Basic Run-Time Error) + - name: Runtime Error 6 href: language-reference/error-messages/overflow-visual-basic-run-time-error.md - - name: Path not found + - name: Runtime Error 76 href: language-reference/error-messages/path-not-found.md - - name: Path-File access error + - name: Runtime Error 75 href: language-reference/error-messages/path-file-access-error.md - - name: Permission denied + - name: Runtime Error 70 href: language-reference/error-messages/permission-denied.md - - name: Procedure call or argument is not valid + - name: Runtime Error 5 href: language-reference/error-messages/procedure-call-or-argument-is-not-valid.md - - name: Property '' doesn't return a value on all code paths + - name: BC42107 href: language-reference/error-messages/property-propertyname-doesn-t-return-a-value-on-all-code-paths.md - - name: Property array index is not valid + - name: Runtime Error 381 href: language-reference/error-messages/property-array-index-is-not-valid.md - - name: Property let procedure not defined and property get procedure did not return an object + - name: Runtime Error 451 href: language-reference/error-messages/property-let-procedure-not-defined-and-property-get-procedure-did-not-return.md - - name: Property not found + - name: Runtime Error 422 href: language-reference/error-messages/property-not-found.md - - name: Property or method not found + - name: Runtime Error 438 href: language-reference/error-messages/property-or-method-not-found.md - - name: Range variable hides a variable in an enclosing block, a previously defined range variable, or an implicitly declared variable in a query expression + - name: BC36633 href: language-reference/error-messages/range-variable-variable-hides-a-variable-in-an-enclosing-block.md - - name: Range variable name can be inferred only from a simple or qualified name with no arguments + - name: BC36599 href: language-reference/error-messages/range-variable-name-can-be-inferred.md - - name: Reference required to assembly '' containing type '', but a suitable reference could not be found due to ambiguity between projects '' and '' + - name: BC30969 href: language-reference/error-messages/reference-required-to-assembly-containing-type-but-suitable-reference-not-found.md - - name: Reference required to assembly '' containing the base class '' + - name: BC30007 href: language-reference/error-messages/reference-required-to-assembly-assemblyname-containing-the-base-class-classname.md - - name: Requested operation is not available (BC35000) + - name: BC35000 href: language-reference/error-messages/bc35000.md - - name: Resume without error + - name: Runtime Error 20 href: language-reference/error-messages/resume-without-error.md - - name: Return type of function '' is not CLS-compliant + - name: BC40027 href: language-reference/error-messages/return-type-of-function-procedurename-is-not-cls-compliant.md - name: "'Set' accessor of property '' is not accessible" href: language-reference/error-messages/set-accessor-of-property-propertyname-is-not-accessible.md - - name: Some subkeys cannot be deleted + - name: Runtime Error 383 href: language-reference/error-messages/some-subkeys-cannot-be-deleted.md - - name: Statement cannot end a block outside of a line 'If' statement + - name: BC32005 href: language-reference/error-messages/statement-cannot-end-a-block-outside-of-a-line-if-statement.md - - name: Statement is not valid in a namespace + - name: BC30001 href: language-reference/error-messages/statement-is-not-valid-in-a-namespace.md - - name: Statement is not valid inside a method-multiline lambda + - name: BC30024 href: language-reference/error-messages/statement-is-not-valid-inside-a-method-multiline-lambda.md - - name: String constants must end with a double quote + - name: BC30648 href: language-reference/error-messages/string-constants-must-end-with-a-double-quote.md - - name: Structure '' must contain at least one instance member variable or at least one instance event declaration not marked 'Custom' + - name: BC30941 href: language-reference/error-messages/structure-structurename-must-contain.md - name: "'Sub Main' was not found in ''" href: language-reference/error-messages/sub-main-was-not-found-in-name.md - - name: Sub or Function not defined + - name: Runtime Error 35 href: language-reference/error-messages/sub-or-function-not-defined.md - - name: Subscript out of range + - name: Runtime Error 9 href: language-reference/error-messages/subscript-out-of-range.md - - name: TextFieldParser is unable to complete the read operation because maximum buffer size has been exceeded + - name: BC31430 href: language-reference/error-messages/textfieldparser-is-unable-to-complete-read-operation.md - - name: The type for variable '' will not be inferred because it is bound to a field in an enclosing scope + - name: BC42110 href: language-reference/error-messages/the-type-for-variable-variablename-will-not-be-inferred.md - - name: This array is fixed or temporarily locked + - name: Runtime Error 10 href: language-reference/error-messages/this-array-is-fixed-or-temporarily-locked.md - - name: This key is already associated with an element of this collection + - name: Runtime Error 457 href: language-reference/error-messages/this-key-is-already-associated-with-an-element-of-this-collection.md - - name: Too many files + - name: Runtime Error 67 href: language-reference/error-messages/too-many-files.md - - name: Type '' has no constructors + - name: BC30251 href: language-reference/error-messages/type-typename-has-no-constructors.md - - name: Type is not CLS-compliant + - name: BC40041 href: language-reference/error-messages/type-typename-is-not-cls-compliant.md - - name: Type '' is not defined + - name: BC30002 href: language-reference/error-messages/type-typename-is-not-defined.md - - name: Type arguments could not be inferred from the delegate + - name: BC36564 href: language-reference/error-messages/type-arguments-could-not-be-inferred-from-the-delegate.md - - name: Type mismatch + - name: Runtime Error 13 href: language-reference/error-messages/type-mismatch.md - - name: Type of '' cannot be inferred because the loop bounds and the step variable do not widen to the same type + - name: BC30982 href: language-reference/error-messages/type-of-variablename-cannot-be-inferred.md - - name: Type of member '' is not CLS-compliant + - name: BC40025 href: language-reference/error-messages/type-of-member-membername-is-not-cls-compliant.md - - name: Type of optional value for optional parameter is not CLS-compliant + - name: BC40042 href: language-reference/error-messages/type-of-optional-value-for-optional-parameter-is-not-cls-compliant.md - - name: Type of parameter '' is not CLS-compliant + - name: BC40028 href: language-reference/error-messages/type-of-parameter-parametername-is-not-cls-compliant.md - - name: Type parameters cannot be used as qualifiers + - name: BC32098 href: language-reference/error-messages/type-parameters-cannot-be-used-as-qualifiers.md - name: "Unable to create strong-named assembly from key file '': " href: language-reference/error-messages/unable-to-create-strong-named-assembly-from-key-file-filename-error.md @@ -1253,45 +1255,45 @@ items: href: language-reference/error-messages/unable-to-embed-resource-file-filename-error-message.md - name: "Unable to emit assembly: " href: language-reference/error-messages/unable-to-emit-assembly-error-message.md - - name: Unable to find required file '' + - name: BC30655 href: language-reference/error-messages/unable-to-find-required-file-filename.md - - name: Unable to get serial port names because of an internal system error + - name: BC31427 href: language-reference/error-messages/unable-to-get-serial-port-names-because-of-an-internal-system-error.md - name: "Unable to link to resource file '': " href: language-reference/error-messages/unable-to-link-to-resource-file-filename-error-message.md - - name: Unable to load information for class '' + - name: BC30712 href: language-reference/error-messages/unable-to-load-information-for-class-classname.md - - name: Unable to write output to memory + - name: BC31020 href: language-reference/error-messages/unable-to-write-output-to-memory.md - - name: Unable to write temporary file because temporary path is not available + - name: BC30698 href: language-reference/error-messages/unable-to-write-temporary-file-because-temporary-path-is-not-available.md - name: "Unable to write to output file '': " href: language-reference/error-messages/unable-to-write-to-output-file-filename-error.md - - name: Underlying type of Enum is not CLS-compliant + - name: BC40032 href: language-reference/error-messages/underlying-type-typename-of-enum-is-not-cls-compliant.md - - name: Using the iteration variable in a lambda expression may have unexpected results + - name: BC42324 href: language-reference/error-messages/using-the-iteration-variable-in-a-lambda-expression-may-have-unexpected-results.md - - name: Value of type '' cannot be converted to '' + - name: BC30955 href: language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2.md - - name: Value of type '' cannot be converted to '' (Multiple file references) + - name: BC30955 (Multiple file references) href: language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2-multiple.md - - name: Value of type 'type1' cannot be converted to 'type2' + - name: BC31194 href: language-reference/error-messages/value-of-type-type1-cannot-be-converted-to-type2.md - - name: Variable '' hides a variable in an enclosing block + - name: BC30616 href: language-reference/error-messages/variable-variablename-hides-a-variable-in-an-enclosing-block.md - - name: Variable '' is used before it has been assigned a value + - name: BC42104 href: language-reference/error-messages/variable-variablename-is-used-before-it-has-been-assigned-a-value.md - - name: Variable uses an Automation type not supported in Visual Basic + - name: Runtime Error 458 href: language-reference/error-messages/variable-uses-an-automation-type-not-supported.md - - name: XML axis properties do not support late binding + - name: BC31168 href: language-reference/error-messages/xml-axis-properties-do-not-support-late-binding.md - - name: XML comment exception must have a 'cref' attribute + - name: BC42319 href: language-reference/error-messages/xml-comment-exception-must-have-a-cref-attribute.md - - name: XML entity references are not supported + - name: BC31180 href: language-reference/error-messages/xml-entity-references-are-not-supported.md - - name: XML literals and XML properties are not supported in embedded code within ASP.NET + - name: BC31200 href: language-reference/error-messages/xml-literals-and-xml-properties-are-not-supported-in-embedded-code-in-aspnet.md - - name: XML namespace URI '' can be bound only to 'xmlns' + - name: BC31183 href: language-reference/error-messages/xml-namespace-uri-uri-can-be-bound-only-to-xmlns.md - name: Reference href: reference/index.md diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb index 6a6cf5a829db3..1100b9e5787df 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb @@ -1,4 +1,7 @@ -Class Class072b9cf6629846f1849e4edc1631564c +Imports System.Windows.Forms +Imports System.Data + +Class Class072b9cf6629846f1849e4edc1631564c ' WithEvents and the Handles Clause ' @@ -225,35 +228,72 @@ Class Class647cd825e8774910b4f18d168beebe6a ' AddHandler Statement ' - Sub TestEvents() + Public Class DataBindingExample + Private textBox1 As TextBox + Private ds As DataSet + + Public Sub New() + textBox1 = New TextBox() + ds = New DataSet() + SetupSampleData() + BindControlWithAddHandler() + End Sub + + Private Sub SetupSampleData() + Dim table As New DataTable("Orders") + table.Columns.Add("OrderAmount", GetType(Decimal)) + table.Rows.Add(123.45D) + table.Rows.Add(67.89D) + ds.Tables.Add(table) + End Sub + + Private Sub BindControlWithAddHandler() + Dim binding As New Binding("Text", ds, "Orders.OrderAmount") + + ' Use AddHandler to associate ConvertEventHandler delegates + AddHandler binding.Format, AddressOf DecimalToCurrency + AddHandler binding.Parse, AddressOf CurrencyToDecimal + + textBox1.DataBindings.Add(binding) + End Sub + + Private Sub DecimalToCurrency(ByVal sender As Object, ByVal e As ConvertEventArgs) + If e.DesiredType IsNot GetType(String) Then + Return + End If + e.Value = CDec(e.Value).ToString("c") + End Sub + + Private Sub CurrencyToDecimal(ByVal sender As Object, ByVal e As ConvertEventArgs) + If e.DesiredType IsNot GetType(Decimal) Then + Return + End If + e.Value = Convert.ToDecimal(e.Value.ToString()) + End Sub + End Class + + ' Simple example for basic AddHandler usage + Sub TestBasicEvents() Dim Obj As New Class1 - ' Associate an event handler with an event. AddHandler Obj.Ev_Event, AddressOf EventHandler - ' Call the method to raise the event. Obj.CauseSomeEvent() - ' Stop handling events. RemoveHandler Obj.Ev_Event, AddressOf EventHandler - ' This event will not be handled. Obj.CauseSomeEvent() - ' Associate an event handler with an event, using a lambda. - ' This handler cannot be removed. + + ' Lambda expression example AddHandler Obj.Ev_Event, Sub () MsgBox("Lambda caught event.") End Sub - ' This event will be handled by the lambda above. Obj.CauseSomeEvent() End Sub Sub EventHandler() - ' Handle the event. MsgBox("EventHandler caught event.") End Sub Public Class Class1 - ' Declare an event. Public Event Ev_Event() Sub CauseSomeEvent() - ' Raise an event. RaiseEvent Ev_Event() End Sub End Class diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/VbVbalrEvents.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/VbVbalrEvents.vbproj index a881def6e1585..d5f841501bf14 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/VbVbalrEvents.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/VbVbalrEvents.vbproj @@ -41,6 +41,7 @@ + @@ -50,6 +51,7 @@ + diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb index 6ee882376c285..eb8880b799ff8 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb @@ -598,6 +598,48 @@ Public Class Class1 ' + '******************************************************************** + ' + Class SampleCollection + ' Define a local collection to store strings. + Private items As New List(Of String) + + ' Define a parameterized property (indexer) for the collection. + Default Public Property Item(ByVal index As Integer) As String + Get + ' Return the item at the specified index. + If index >= 0 AndAlso index < items.Count Then + Return items(index) + Else + Return Nothing + End If + End Get + Set(ByVal value As String) + ' Set the item at the specified index. + If index >= 0 AndAlso index < items.Count Then + items(index) = value + ElseIf index = items.Count Then + ' Allow adding new items at the end. + items.Add(value) + End If + End Set + End Property + + ' Add a Count property for convenience. + Public ReadOnly Property Count As Integer + Get + Return items.Count + End Get + End Property + + ' Add method to add items. + Public Sub Add(ByVal item As String) + items.Add(item) + End Sub + End Class + ' + + '******************************************************************** ' Public Structure abc diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/Class1.vb b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/Class1.vb index 70e2023aee777..c3ab51f528676 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/Class1.vb +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/Class1.vb @@ -168,6 +168,20 @@ Public Class Test ' Code goes here. End Sub ' + + ' + ' + ''' + ''' Compares two items of type . + ''' + ''' The type of items to compare. + ''' The first item of type . + ''' The second item of type . + ''' True if the items are equal, False otherwise. + Public Function CompareItems(Of T As IComparable)(ByVal item1 As T, ByVal item2 As T) As Boolean + Return item1.CompareTo(item2) = 0 + End Function + ' End Class ' 925e5342-be05-45f2-bf66-7398bbd6710e.xml diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/VbVbcnXmlDocComments.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/VbVbcnXmlDocComments.vbproj new file mode 100644 index 0000000000000..6c01204549952 --- /dev/null +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/VbVbcnXmlDocComments.vbproj @@ -0,0 +1,9 @@ + + + + net9.0 + VbVbcnXmlDocComments + true + + + \ No newline at end of file