From 0dfeb213fbe324e54d4e03df79763340406a4dad Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 22:35:53 +0000 Subject: [PATCH 1/2] Initial plan From a86ec2b05d5c4d1bc5e9cf679adcf90e76e3104c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 22:41:19 +0000 Subject: [PATCH 2/2] Add diagnostics doc for ASPIREAZURE003 (Azure Virtual Networks) Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com> --- .../config/sidebar/reference.topics.ts | 1 + .../docs/diagnostics/aspireazure003.mdx | 49 +++++++++++++++++++ .../src/content/docs/diagnostics/overview.mdx | 1 + 3 files changed, 51 insertions(+) create mode 100644 src/frontend/src/content/docs/diagnostics/aspireazure003.mdx diff --git a/src/frontend/config/sidebar/reference.topics.ts b/src/frontend/config/sidebar/reference.topics.ts index c4972465..66a68224 100644 --- a/src/frontend/config/sidebar/reference.topics.ts +++ b/src/frontend/config/sidebar/reference.topics.ts @@ -534,6 +534,7 @@ export const referenceTopics: StarlightSidebarTopicsUserConfig = { }, { label: 'ASPIREAZURE001', link: '/diagnostics/aspireazure001' }, { label: 'ASPIREAZURE002', link: '/diagnostics/aspireazure002' }, + { label: 'ASPIREAZURE003', link: '/diagnostics/aspireazure003' }, ], }, ], diff --git a/src/frontend/src/content/docs/diagnostics/aspireazure003.mdx b/src/frontend/src/content/docs/diagnostics/aspireazure003.mdx new file mode 100644 index 00000000..ead4c5a8 --- /dev/null +++ b/src/frontend/src/content/docs/diagnostics/aspireazure003.mdx @@ -0,0 +1,49 @@ +--- +title: Compiler Error ASPIREAZURE003 +description: Learn more about compiler Error ASPIREAZURE003. Azure Virtual Network types and members are for evaluation purposes only and are subject to change or removal in future updates. +--- + +import { Badge } from '@astrojs/starlight/components'; + + + +> Azure Virtual Network types and members are for evaluation purposes only and are subject to change or removal in future updates. Suppress this diagnostic to proceed. + +The Aspire Azure hosting integration now ships with support for Azure Virtual Networks. If you're using any of the `Aspire.Hosting.Azure.Network` APIs such as `AddAzureVirtualNetwork`, you might see a compiler error/warning indicating that the API is experimental. This behavior is expected, as the API is still in preview and the shape of this API is expected to change in the future. + +## Example + +The following code generates `ASPIREAZURE003`: + +```csharp title="C# — AppHost.cs" +var vnet = builder.AddAzureVirtualNetwork("vnet"); +var subnet = vnet.AddSubnet("pe-subnet", "10.0.1.0/24"); +``` + +## To correct this error + +Suppress the error with either of the following methods: + +- Set the severity of the rule in the _.editorconfig_ file. + + ```ini title=".editorconfig" + [*.{cs,vb}] + dotnet_diagnostic.ASPIREAZURE003.severity = none + ``` + + For more information about editor config files, see [Configuration files for code analysis rules](/diagnostics/overview/#suppress-in-the-editorconfig-file). + +- Add the following `PropertyGroup` to your project file: + + ```xml title="C# project file" + + $(NoWarn);ASPIREAZURE003 + + ``` + +- Suppress in code with the `#pragma warning disable ASPIREAZURE003` directive. diff --git a/src/frontend/src/content/docs/diagnostics/overview.mdx b/src/frontend/src/content/docs/diagnostics/overview.mdx index dd1050b4..ea27ee1b 100644 --- a/src/frontend/src/content/docs/diagnostics/overview.mdx +++ b/src/frontend/src/content/docs/diagnostics/overview.mdx @@ -18,6 +18,7 @@ The following table lists the possible MSBuild and analyzer warnings and errors | [ASPIREATS001](/diagnostics/aspireats001/) | (Experimental) Warning | ATS (Aspire Type Specification) types are for evaluation purposes only and are subject to change or removal in future updates. | | [ASPIREAZURE001](/diagnostics/aspireazure001/) | (Experimental) Error | Publishers are for evaluation purposes only and are subject to change or removal in future updates. | | [ASPIREAZURE002](/diagnostics/aspireazure002/) | (Experimental) Error | Azure Container App Jobs are for evaluation purposes only and are subject to change or removal in future updates. | +| [ASPIREAZURE003](/diagnostics/aspireazure003/) | (Experimental) Error | Azure Virtual Network types and members are for evaluation purposes only and are subject to change or removal in future updates. | | [ASPIRECERTIFICATES001](/diagnostics/aspirecertificates001/) | (Experimental) Warning | Certificate configuration types and members are for evaluation purposes only and are subject to change or removal in future updates. | | [ASPIRECOMPUTE001](/diagnostics/aspirecompute001/) | (Experimental) Error | Compute related types and members are for evaluation purposes only and is subject to change or removal in future updates. | | [ASPIRECOMPUTE002](/diagnostics/aspirecompute002/) | (Experimental) Warning | The GetHostAddressExpression method is for evaluation purposes only and is subject to change or removal in future updates. |