Skip to content

Update SW103 migration docs to use Aspire wrapper client registrations #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Update SW103 migration docs to use Aspire wrapper client registrations #5

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
10cbb00
Initial plan
Copilot May 31, 2026
235380c
docs: update SW103 Aspire wrapper migration guidance
Copilot May 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 18 additions & 8 deletions docs/docs/rules/sw103-avoid-microsoft-extensions-azure.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,13 +64,19 @@ builder.Services.AddAzureClients(clients =>
// Program.cs / Startup.cs
// No Microsoft.Extensions.Azure import required

builder.Services.AddKeyedSingleton<BlobServiceClient>("blob-storage", (sp, _) =>
new BlobServiceClient(
builder.Configuration.GetConnectionString("BlobStorage")));
builder.Services.AddAzureBlobClient("blob-storage");
builder.Services.AddAzureQueueClient("order-queue");
builder.Services.AddAzureTableClient("order-table");
```

These Aspire wrappers keep the same resource key naming story and register keyed clients that can be resolved with `[FromKeyedServices("...")]`.

builder.Services.AddKeyedSingleton<QueueServiceClient>("order-queue", (sp, _) =>
new QueueServiceClient(
builder.Configuration.GetConnectionString("OrderQueue")));
```csharp
public class QueueWorker(
[FromKeyedServices("order-queue")] QueueServiceClient queueClient,
[FromKeyedServices("order-table")] TableServiceClient tableClient)
{
}
```

#### DI callsite — before (`IAzureClientFactory<T>`)
Expand Down Expand Up @@ -112,8 +118,12 @@ public class BlobUploadService

## Related Documentation

- Aspire Azure Storage Blobs integration (keyed/resource-oriented approach):
https://aspire.dev/integrations/cloud/azure/azure-storage-blobs/azure-storage-blobs-connect/#blob-storage-resource
- Aspire Azure Storage Blobs client:
https://aspire.dev/integrations/cloud/azure/azure-storage-blobs/azure-storage-blobs-client/
- Aspire Azure Storage Queues client:
https://aspire.dev/integrations/cloud/azure/azure-storage-queues/azure-storage-queues-client/
- Aspire Azure Data Tables client:
https://aspire.dev/integrations/cloud/azure/azure-data-tables/azure-data-tables-client/
- Azure SDK discussion:
https://github.com/Azure/azure-sdk-for-net/issues/40408#issuecomment-3599496883
- Azure SDK follow-up issue:
Expand Down