diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 515b7e966c1cb..beb40e80e8a85 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -52,8 +52,8 @@ | Health Insights Cancer Profiling | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.CancerProfiling/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.CancerProfiling-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.CancerProfiling_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/) | | Health Insights Clinical Matching | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.ClinicalMatching/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.ClinicalMatching-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.ClinicalMatching_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/) | | Health Insights Radiology Insights | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Health.Insights.RadiologyInsights/1.1.0) | [docs](/dotnet/api/overview/azure/Health.Insights.RadiologyInsights-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.RadiologyInsights_1.1.0/sdk/healthinsights/Azure.Health.Insights.RadiologyInsights/) | -| Identity | NuGet [1.17.1](https://www.nuget.org/packages/Azure.Identity/1.17.1)
NuGet [1.18.0-beta.3](https://www.nuget.org/packages/Azure.Identity/1.18.0-beta.3) | [docs](/dotnet/api/overview/azure/Identity-readme) | GitHub [1.17.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity_1.17.1/sdk/identity/Azure.Identity/)
GitHub [1.18.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity_1.18.0-beta.3/sdk/identity/Azure.Identity/) | -| Identity Broker | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Identity.Broker/1.3.1) | [docs](/dotnet/api/overview/azure/Identity.Broker-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity.Broker_1.3.1/sdk/identity/Azure.Identity.Broker/) | +| Identity | NuGet [1.18.0](https://www.nuget.org/packages/Azure.Identity/1.18.0) | [docs](/dotnet/api/overview/azure/Identity-readme) | GitHub [1.18.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity_1.18.0/sdk/identity/Azure.Identity/) | +| Identity Broker | NuGet [1.4.0](https://www.nuget.org/packages/Azure.Identity.Broker/1.4.0) | [docs](/dotnet/api/overview/azure/Identity.Broker-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity.Broker_1.4.0/sdk/identity/Azure.Identity.Broker/) | | Image Analysis | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Vision.ImageAnalysis/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Vision.ImageAnalysis-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Vision.ImageAnalysis_1.0.0/sdk/vision/Azure.AI.Vision.ImageAnalysis/) | | Key Vault - Administration | NuGet [4.6.0](https://www.nuget.org/packages/Azure.Security.KeyVault.Administration/4.6.0) | [docs](/dotnet/api/overview/azure/Security.KeyVault.Administration-readme) | GitHub [4.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Security.KeyVault.Administration_4.6.0/sdk/keyvault/Azure.Security.KeyVault.Administration/) | | Key Vault - Certificates | NuGet [4.8.0](https://www.nuget.org/packages/Azure.Security.KeyVault.Certificates/4.8.0) | [docs](/dotnet/api/overview/azure/Security.KeyVault.Certificates-readme) | GitHub [4.8.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Security.KeyVault.Certificates_4.8.0/sdk/keyvault/Azure.Security.KeyVault.Certificates/) | @@ -118,7 +118,7 @@ | unknown | NuGet [1.0.0-beta.8](https://www.nuget.org/packages/Azure.AI.AgentServer.AgentFramework/1.0.0-beta.8) | [docs](/dotnet/api/overview/azure/AI.AgentServer.AgentFramework-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AgentServer.AgentFramework_1.0.0-beta.8/sdk/agentserver/Azure.AI.AgentServer.AgentFramework/) | | unknown | NuGet [1.0.0-beta.8](https://www.nuget.org/packages/Azure.AI.AgentServer.Contracts/1.0.0-beta.8) | [docs](/dotnet/api/overview/azure/AI.AgentServer.Contracts-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AgentServer.Contracts_1.0.0-beta.8/sdk/agentserver/Azure.AI.AgentServer.Contracts/) | | unknown | NuGet [1.0.0-beta.8](https://www.nuget.org/packages/Azure.AI.AgentServer.Core/1.0.0-beta.8) | [docs](/dotnet/api/overview/azure/AI.AgentServer.Core-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AgentServer.Core_1.0.0-beta.8/sdk/agentserver/Azure.AI.AgentServer.Core/) | -| unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.ContentUnderstanding/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.ContentUnderstanding-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.ContentUnderstanding_1.0.0-beta.1/sdk/contentunderstanding/Azure.AI.ContentUnderstanding/) | +| unknown | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.ContentUnderstanding/1.0.0) | [docs](/dotnet/api/overview/azure/AI.ContentUnderstanding-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.ContentUnderstanding_1.0.0/sdk/contentunderstanding/Azure.AI.ContentUnderstanding/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Language.QuestionAnswering.Authoring/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Language.QuestionAnswering.Authoring-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.QuestionAnswering.Authoring_1.0.0-beta.1/sdk/cognitivelanguage/Azure.AI.Language.QuestionAnswering.Authoring/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Language.QuestionAnswering.Inference/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Language.QuestionAnswering.Inference-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.QuestionAnswering.Inference_1.0.0-beta.1/sdk/cognitivelanguage/Azure.AI.Language.QuestionAnswering.Inference/) | | unknown | NuGet [2.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Projects.OpenAI/2.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Projects.OpenAI-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [2.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects.OpenAI_2.0.0-beta.1/sdk/ai/Azure.AI.Projects.OpenAI/) | @@ -195,13 +195,13 @@ | Resource Management - Azure AI Search | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Search/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Search-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Search_1.3.0/sdk/search/Azure.ResourceManager.Search/) | | Resource Management - Azure Stack HCI | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.Hci/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Hci-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Hci_1.2.1/sdk/azurestackhci/Azure.ResourceManager.Hci/) | | Resource Management - Azure VMware Solution | NuGet [1.6.0](https://www.nuget.org/packages/Azure.ResourceManager.Avs/1.6.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Avs-readme) | GitHub [1.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Avs_1.6.0/sdk/avs/Azure.ResourceManager.Avs/) | -| Resource Management - Batch | NuGet [1.5.0](https://www.nuget.org/packages/Azure.ResourceManager.Batch/1.5.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Batch-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Batch_1.5.0/sdk/batch/Azure.ResourceManager.Batch/) | +| Resource Management - Batch | NuGet [1.6.0](https://www.nuget.org/packages/Azure.ResourceManager.Batch/1.6.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Batch-readme) | GitHub [1.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Batch_1.6.0/sdk/batch/Azure.ResourceManager.Batch/) | | Resource Management - Billing | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.Billing/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Billing-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Billing_1.2.1/sdk/billing/Azure.ResourceManager.Billing/) | | Resource Management - Billing Benefits | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.BillingBenefits/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.BillingBenefits-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.BillingBenefits_1.0.0-beta.4/sdk/billingbenefits/Azure.ResourceManager.BillingBenefits/) | | Resource Management - Blueprint | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.Blueprint/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.Blueprint-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Blueprint_1.0.0-beta.5/sdk/blueprint/Azure.ResourceManager.Blueprint/) | | Resource Management - Bot Service | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.BotService/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.BotService-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.BotService_1.1.1/sdk/botservice/Azure.ResourceManager.BotService/) | | Resource Management - Carbonoptimization | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.CarbonOptimization/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.CarbonOptimization-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CarbonOptimization_1.0.0/sdk/carbon/Azure.ResourceManager.CarbonOptimization/) | -| Resource Management - Certificateregistration | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CertificateRegistration/1.0.0-beta.1) | | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CertificateRegistration_1.0.0-beta.1/sdk/certificateregistration/Azure.ResourceManager.CertificateRegistration/) | +| Resource Management - Certificateregistration | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CertificateRegistration/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CertificateRegistration-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.CertificateRegistration_1.0.0-beta.1/sdk/certificateregistration/Azure.ResourceManager.CertificateRegistration/) | | Resource Management - Change Analysis | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.ChangeAnalysis/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ChangeAnalysis-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ChangeAnalysis_1.1.1/sdk/changeanalysis/Azure.ResourceManager.ChangeAnalysis/) | | Resource Management - Chaos | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Chaos-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.1.0/sdk/chaos/Azure.ResourceManager.Chaos/) | | Resource Management - Cloudhealth | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CloudHealth/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CloudHealth-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.CloudHealth_1.0.0-beta.1/sdk/cloudhealth/Azure.ResourceManager.CloudHealth/) | @@ -544,7 +544,7 @@ | App Service - API Apps Service | NuGet [0.9.64](https://www.nuget.org/packages/Microsoft.Azure.AppService.ApiApps.Service/0.9.64) | | | | Code Analyzers for Durable Functions | NuGet [0.5.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask.Analyzers/0.5.0) | | GitHub [0.5.0](https://github.com/Azure/azure-functions-durable-extension/tree/Analyzer-v0.3.0/src/WebJobs.Extensions.DurableTask.Analyzers) | | Cosmos DB - BulkExecutor | NuGet [2.5.1-preview](https://www.nuget.org/packages/Microsoft.Azure.CosmosDB.BulkExecutor/2.5.1-preview) | | GitHub [2.5.1-preview](https://github.com/Azure/azure-cosmosdb-bulkexecutor-dotnet-getting-started) | -| Cosmos DB - Direct | NuGet [3.42.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Direct/3.42.0) | | GitHub [3.42.0](https://github.com/Azure/azure-cosmos-dotnet-v3) | +| Cosmos DB - Direct | NuGet [3.42.1](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Direct/3.42.1) | | GitHub [3.42.1](https://github.com/Azure/azure-cosmos-dotnet-v3) | | Cosmos DB - Encryption | NuGet [2.0.3](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption/2.0.3)
NuGet [2.1.0-preview4](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption/2.1.0-preview4) | | GitHub [2.0.3](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/releases/encryption/1.0.0-preview4/Microsoft.Azure.Cosmos.Encryption) | | Cosmos DB - Encryption | NuGet [1.0.0-preview07](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption.Custom/1.0.0-preview07) | | | | Extensions - Caching Cosmos | NuGet [1.8.0](https://www.nuget.org/packages/Microsoft.Extensions.Caching.Cosmos/1.8.0) | | GitHub [1.8.0](https://github.com/Azure/Microsoft.Extensions.Caching.Cosmos/tree/v1.0.0-preview4) | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index 95cda59cdfde7..13657cc67b39b 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -56,8 +56,8 @@ | Health Insights Cancer Profiling | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.CancerProfiling/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.CancerProfiling-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.CancerProfiling_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/) | | Health Insights Clinical Matching | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.ClinicalMatching/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.ClinicalMatching-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.ClinicalMatching_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/) | | Health Insights Radiology Insights | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Health.Insights.RadiologyInsights/1.1.0) | [docs](/dotnet/api/overview/azure/Health.Insights.RadiologyInsights-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.RadiologyInsights_1.1.0/sdk/healthinsights/Azure.Health.Insights.RadiologyInsights/) | -| Identity | NuGet [1.17.1](https://www.nuget.org/packages/Azure.Identity/1.17.1)
NuGet [1.18.0-beta.3](https://www.nuget.org/packages/Azure.Identity/1.18.0-beta.3) | [docs](/dotnet/api/overview/azure/Identity-readme) | GitHub [1.17.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity_1.17.1/sdk/identity/Azure.Identity/)
GitHub [1.18.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity_1.18.0-beta.3/sdk/identity/Azure.Identity/) | -| Identity Broker | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Identity.Broker/1.3.1) | [docs](/dotnet/api/overview/azure/Identity.Broker-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity.Broker_1.3.1/sdk/identity/Azure.Identity.Broker/) | +| Identity | NuGet [1.18.0](https://www.nuget.org/packages/Azure.Identity/1.18.0) | [docs](/dotnet/api/overview/azure/Identity-readme) | GitHub [1.18.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity_1.18.0/sdk/identity/Azure.Identity/) | +| Identity Broker | NuGet [1.4.0](https://www.nuget.org/packages/Azure.Identity.Broker/1.4.0) | [docs](/dotnet/api/overview/azure/Identity.Broker-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Identity.Broker_1.4.0/sdk/identity/Azure.Identity.Broker/) | | Image Analysis | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Vision.ImageAnalysis/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Vision.ImageAnalysis-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Vision.ImageAnalysis_1.0.0/sdk/vision/Azure.AI.Vision.ImageAnalysis/) | | Key Vault - Administration | NuGet [4.6.0](https://www.nuget.org/packages/Azure.Security.KeyVault.Administration/4.6.0) | [docs](/dotnet/api/overview/azure/Security.KeyVault.Administration-readme) | GitHub [4.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Security.KeyVault.Administration_4.6.0/sdk/keyvault/Azure.Security.KeyVault.Administration/) | | Key Vault - Certificates | NuGet [4.8.0](https://www.nuget.org/packages/Azure.Security.KeyVault.Certificates/4.8.0) | [docs](/dotnet/api/overview/azure/Security.KeyVault.Certificates-readme) | GitHub [4.8.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Security.KeyVault.Certificates_4.8.0/sdk/keyvault/Azure.Security.KeyVault.Certificates/) | @@ -130,7 +130,7 @@ | unknown | NuGet [1.0.0-beta.8](https://www.nuget.org/packages/Azure.AI.AgentServer.AgentFramework/1.0.0-beta.8) | [docs](/dotnet/api/overview/azure/AI.AgentServer.AgentFramework-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AgentServer.AgentFramework_1.0.0-beta.8/sdk/agentserver/Azure.AI.AgentServer.AgentFramework/) | | unknown | NuGet [1.0.0-beta.8](https://www.nuget.org/packages/Azure.AI.AgentServer.Contracts/1.0.0-beta.8) | [docs](/dotnet/api/overview/azure/AI.AgentServer.Contracts-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AgentServer.Contracts_1.0.0-beta.8/sdk/agentserver/Azure.AI.AgentServer.Contracts/) | | unknown | NuGet [1.0.0-beta.8](https://www.nuget.org/packages/Azure.AI.AgentServer.Core/1.0.0-beta.8) | [docs](/dotnet/api/overview/azure/AI.AgentServer.Core-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AgentServer.Core_1.0.0-beta.8/sdk/agentserver/Azure.AI.AgentServer.Core/) | -| unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.ContentUnderstanding/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.ContentUnderstanding-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.ContentUnderstanding_1.0.0-beta.1/sdk/contentunderstanding/Azure.AI.ContentUnderstanding/) | +| unknown | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.ContentUnderstanding/1.0.0) | [docs](/dotnet/api/overview/azure/AI.ContentUnderstanding-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.ContentUnderstanding_1.0.0/sdk/contentunderstanding/Azure.AI.ContentUnderstanding/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Language.QuestionAnswering.Authoring/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Language.QuestionAnswering.Authoring-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.QuestionAnswering.Authoring_1.0.0-beta.1/sdk/cognitivelanguage/Azure.AI.Language.QuestionAnswering.Authoring/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Language.QuestionAnswering.Inference/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Language.QuestionAnswering.Inference-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.QuestionAnswering.Inference_1.0.0-beta.1/sdk/cognitivelanguage/Azure.AI.Language.QuestionAnswering.Inference/) | | unknown | NuGet [2.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Projects.OpenAI/2.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Projects.OpenAI-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [2.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects.OpenAI_2.0.0-beta.1/sdk/ai/Azure.AI.Projects.OpenAI/) | @@ -210,13 +210,13 @@ | Resource Management - Azure AI Search | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Search/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Search-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Search_1.3.0/sdk/search/Azure.ResourceManager.Search/) | | Resource Management - Azure Stack HCI | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.Hci/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Hci-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Hci_1.2.1/sdk/azurestackhci/Azure.ResourceManager.Hci/) | | Resource Management - Azure VMware Solution | NuGet [1.6.0](https://www.nuget.org/packages/Azure.ResourceManager.Avs/1.6.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Avs-readme) | GitHub [1.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Avs_1.6.0/sdk/avs/Azure.ResourceManager.Avs/) | -| Resource Management - Batch | NuGet [1.5.0](https://www.nuget.org/packages/Azure.ResourceManager.Batch/1.5.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Batch-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Batch_1.5.0/sdk/batch/Azure.ResourceManager.Batch/) | +| Resource Management - Batch | NuGet [1.6.0](https://www.nuget.org/packages/Azure.ResourceManager.Batch/1.6.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Batch-readme) | GitHub [1.6.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Batch_1.6.0/sdk/batch/Azure.ResourceManager.Batch/) | | Resource Management - Billing | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.Billing/1.2.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Billing-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Billing_1.2.1/sdk/billing/Azure.ResourceManager.Billing/) | | Resource Management - Billing Benefits | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.BillingBenefits/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.BillingBenefits-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.BillingBenefits_1.0.0-beta.4/sdk/billingbenefits/Azure.ResourceManager.BillingBenefits/) | | Resource Management - Blueprint | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.Blueprint/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.Blueprint-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Blueprint_1.0.0-beta.5/sdk/blueprint/Azure.ResourceManager.Blueprint/) | | Resource Management - Bot Service | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.BotService/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.BotService-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.BotService_1.1.1/sdk/botservice/Azure.ResourceManager.BotService/) | | Resource Management - Carbonoptimization | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.CarbonOptimization/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.CarbonOptimization-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CarbonOptimization_1.0.0/sdk/carbon/Azure.ResourceManager.CarbonOptimization/) | -| Resource Management - Certificateregistration | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CertificateRegistration/1.0.0-beta.1) | | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CertificateRegistration_1.0.0-beta.1/sdk/certificateregistration/Azure.ResourceManager.CertificateRegistration/) | +| Resource Management - Certificateregistration | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CertificateRegistration/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CertificateRegistration-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.CertificateRegistration_1.0.0-beta.1/sdk/certificateregistration/Azure.ResourceManager.CertificateRegistration/) | | Resource Management - Change Analysis | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.ChangeAnalysis/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ChangeAnalysis-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ChangeAnalysis_1.1.1/sdk/changeanalysis/Azure.ResourceManager.ChangeAnalysis/) | | Resource Management - Chaos | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Chaos-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.1.0/sdk/chaos/Azure.ResourceManager.Chaos/) | | Resource Management - Cloudhealth | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.CloudHealth/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CloudHealth-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.CloudHealth_1.0.0-beta.1/sdk/cloudhealth/Azure.ResourceManager.CloudHealth/) | diff --git a/docs/core/extensions/dependency-injection/overview.md b/docs/core/extensions/dependency-injection/overview.md index a42bb1ae0dd65..5d5f00af62bb7 100644 --- a/docs/core/extensions/dependency-injection/overview.md +++ b/docs/core/extensions/dependency-injection/overview.md @@ -10,27 +10,16 @@ ai-usage: ai-assisted .NET supports the *dependency injection* (DI) software design pattern, which is a technique for achieving [Inversion of Control (IoC)](../../../architecture/modern-web-apps-azure/architectural-principles.md#dependency-inversion) between classes and their dependencies. Dependency injection in .NET is a built-in part of the framework, along with configuration, logging, and the options pattern. +> [!IMPORTANT] +> The examples in this article use the `Microsoft.NET.Sdk.Worker` SDK. For more information, see [Worker services in .NET](../workers.md). + A *dependency* is an object that another object depends on. The following `MessageWriter` class has a `Write` method that other classes might depend on: :::code language="csharp" source="snippets/overview/Program.cs" id="SnippetMW"::: A class can create an instance of the `MessageWriter` class to use its `Write` method. In the following example, the `MessageWriter` class is a *dependency* of the `Worker` class: -```csharp -public class Worker : BackgroundService -{ - private readonly MessageWriter _messageWriter = new(); - - protected override async Task ExecuteAsync(CancellationToken stoppingToken) - { - while (!stoppingToken.IsCancellationRequested) - { - _messageWriter.Write($"Worker running at: {DateTimeOffset.Now}"); - await Task.Delay(1_000, stoppingToken); - } - } -} -``` +:::code language="csharp" source="snippets/overview/StandaloneWorker.cs" id="WorkerClass"::: In this case, the `Worker` class creates and directly depends on the `MessageWriter` class. Hard-coded dependencies like this are problematic and should be avoided for the following reasons: @@ -47,6 +36,9 @@ Dependency injection addresses hard-coded dependency problems through: .NET provides a built-in service container, . Services are typically registered at the app's start-up and appended to an . Once all services are added, use to create the service container. + > [!IMPORTANT] + > Desktop apps control their own lifetime. Frameworks like WPF and Windows Forms require you to integrate the host lifetime with the application lifetime events. + - Injection of the service into the constructor of the class where it's used. The framework takes on the responsibility of creating an instance of the dependency and disposing of it when it's no longer needed. @@ -56,7 +48,10 @@ Dependency injection addresses hard-coded dependency problems through: As an example, assume the `IMessageWriter` interface defines the `Write` method. This interface is implemented by a concrete type, `MessageWriter`, shown previously. The following sample code registers the `IMessageWriter` service with the concrete type `MessageWriter`. The method registers the service with a [*singleton* lifetime](service-lifetimes.md#singleton), which means it isn't disposed until the app shuts down. -:::code language="csharp" source="snippets/overview/Program.cs" highlight="3-6"::: +> [!IMPORTANT] +> The [`Microsoft.Extensions.Hosting` NuGet package](https://www.nuget.org/packages/Microsoft.Extensions.Hosting/) provides the types used in this article. + +:::code language="csharp" source="snippets/overview/Program.cs" highlight="5-8" id="All"::: In the preceding code example, the highlighted lines: diff --git a/docs/core/extensions/dependency-injection/snippets/overview/Program.cs b/docs/core/extensions/dependency-injection/snippets/overview/Program.cs index 2708ce60a7cc0..1038d54fd85a3 100644 --- a/docs/core/extensions/dependency-injection/snippets/overview/Program.cs +++ b/docs/core/extensions/dependency-injection/snippets/overview/Program.cs @@ -1,4 +1,8 @@ -HostApplicationBuilder builder = Host.CreateApplicationBuilder(args); +// +using Microsoft.Extensions.Hosting; +using Microsoft.Extensions.DependencyInjection; + +HostApplicationBuilder builder = Host.CreateApplicationBuilder(args); builder.Services.AddHostedService(); builder.Services.AddSingleton(); @@ -24,7 +28,6 @@ public interface IMessageWriter } // -// public sealed class Worker(IMessageWriter messageWriter) : BackgroundService { protected override async Task ExecuteAsync(CancellationToken stoppingToken) @@ -36,5 +39,4 @@ protected override async Task ExecuteAsync(CancellationToken stoppingToken) } } } - -// +// diff --git a/docs/core/extensions/dependency-injection/snippets/overview/StandaloneWorker.cs b/docs/core/extensions/dependency-injection/snippets/overview/StandaloneWorker.cs new file mode 100644 index 0000000000000..90ee069e0297e --- /dev/null +++ b/docs/core/extensions/dependency-injection/snippets/overview/StandaloneWorker.cs @@ -0,0 +1,20 @@ +using Microsoft.Extensions.Hosting; +using Microsoft.Extensions.DependencyInjection; + +namespace Standalone; + +// +public class Worker : BackgroundService +{ + private readonly MessageWriter _messageWriter = new(); + + protected override async Task ExecuteAsync(CancellationToken stoppingToken) + { + while (!stoppingToken.IsCancellationRequested) + { + _messageWriter.Write($"Worker running at: {DateTimeOffset.Now}"); + await Task.Delay(1_000, stoppingToken); + } + } +} +// diff --git a/docs/standard/datetime/how-to-use-dateonly-timeonly.md b/docs/standard/datetime/how-to-use-dateonly-timeonly.md index e4ebb68226a66..71954d5d41c04 100644 --- a/docs/standard/datetime/how-to-use-dateonly-timeonly.md +++ b/docs/standard/datetime/how-to-use-dateonly-timeonly.md @@ -127,7 +127,26 @@ Because `TimeOnly` only represents a 24-hour period, it rolls over forwards or b ### Serialize DateOnly and TimeOnly types -[!INCLUDE [dateonly-and-timeonly-serialization](includes/dateonly-and-timeonly-serialization.md)] + + +Starting in .NET 7, `System.Text.Json` supports serializing and deserializing and types. Consider the following object: + +:::code source="./snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="appointment"::: +:::code source="./snippets/how-to-use-dateonly-timeonly/vb/Program.vb" id="appointment"::: + +The following example serializes an `Appointment` object, displays the resulting JSON, and then deserializes it back into a new instance of the `Appointment` type. Finally, the original and newly deserialized instances are compared for equality and the results are written to the console: + +:::code source="./snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="serialization"::: +:::code source="./snippets/how-to-use-dateonly-timeonly/vb/Program.vb" id="serialization"::: + +In the preceding code: + +- An `Appointment` object is instantiated and assigned to the `appointment` variable. +- The `appointment` instance is serialized to JSON using . +- The resulting JSON is written to the console. +- The JSON is deserialized back into a new instance of the `Appointment` type using . +- The original and newly deserialized instances are compared for equality. +- The result of the comparison is written to the console. For more information, see [How to serialize and deserialize JSON in .NET](../serialization/system-text-json/how-to.md). diff --git a/docs/standard/datetime/includes/dateonly-and-timeonly-serialization-cs.md b/docs/standard/datetime/includes/dateonly-and-timeonly-serialization-cs.md deleted file mode 100644 index 68d8b78560323..0000000000000 --- a/docs/standard/datetime/includes/dateonly-and-timeonly-serialization-cs.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -ms.date: 01/11/2023 -ms.topic: include ---- - -With .NET 7+, `System.Text.Json` supports serializing and deserializing and types. Consider the following object: - -:::code source="../snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="appointment"::: - -The following example serializes an `Appointment` object, displays the resulting JSON, and then deserializes it back into a new instance of the `Appointment` type. Finally, the original and newly deserialized instances are compared for equality and the results are written to the console: - -:::code source="../snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="serialization"::: - -In the preceding code: - -- An `Appointment` object is instantiated and assigned to the `appointment` variable. -- The `appointment` instance is serialized to JSON using . -- The resulting JSON is written to the console. -- The JSON is deserialized back into a new instance of the `Appointment` type using . -- The original and newly deserialized instances are compared for equality. -- The result of the comparison is written to the console. diff --git a/docs/standard/datetime/includes/dateonly-and-timeonly-serialization.md b/docs/standard/datetime/includes/dateonly-and-timeonly-serialization.md deleted file mode 100644 index 992c3e32acd7e..0000000000000 --- a/docs/standard/datetime/includes/dateonly-and-timeonly-serialization.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -ms.date: 01/11/2023 -ms.topic: include ---- - -With .NET 7+, `System.Text.Json` supports serializing and deserializing and types. Consider the following object: - -:::code source="../snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="appointment"::: -:::code source="../snippets/how-to-use-dateonly-timeonly/vb/Program.vb" id="appointment"::: - -The following example serializes an `Appointment` object, displays the resulting JSON, and then deserializes it back into a new instance of the `Appointment` type. Finally, the original and newly deserialized instances are compared for equality and the results are written to the console: - -:::code source="../snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="serialization"::: -:::code source="../snippets/how-to-use-dateonly-timeonly/vb/Program.vb" id="serialization"::: - -In the preceding code: - -- An `Appointment` object is instantiated and assigned to the `appointment` variable. -- The `appointment` instance is serialized to JSON using . -- The resulting JSON is written to the console. -- The JSON is deserialized back into a new instance of the `Appointment` type using . -- The original and newly deserialized instances are compared for equality. -- The result of the comparison is written to the console. diff --git a/docs/standard/datetime/system-text-json-support.md b/docs/standard/datetime/system-text-json-support.md index e995755d37193..8d67d2948aaf5 100644 --- a/docs/standard/datetime/system-text-json-support.md +++ b/docs/standard/datetime/system-text-json-support.md @@ -59,7 +59,24 @@ If you attempt to read non-compliant formats with and types. Consider the following object: + + + +:::code source="snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="appointment"::: + +The following example serializes an `Appointment` object, displays the resulting JSON, and then deserializes it back into a new instance of the `Appointment` type. Finally, the original and newly deserialized instances are compared for equality and the results are written to the console: + +:::code source="snippets/how-to-use-dateonly-timeonly/csharp/Program.cs" id="serialization"::: + +In the preceding code: + +- An `Appointment` object is instantiated and assigned to the `appointment` variable. +- The `appointment` instance is serialized to JSON using . +- The resulting JSON is written to the console. +- The JSON is deserialized back into a new instance of the `Appointment` type using . +- The original and newly deserialized instances are compared for equality. +- The result of the comparison is written to the console. ## Custom support for and