Enable WAM Broker support for Entra ID Auth modes

Directory.Packages.props

@@ -102,6 +102,7 @@
 
   <ItemGroup>
     <PackageVersion Include="Azure.Identity" Version="1.18.0" />
+    <PackageVersion Include="Microsoft.Identity.Client.Broker" Version="4.83.0" />
   </ItemGroup>
 
   <!-- ===================================================================== -->

doc/apps/AzureSqlConnector/AzureSqlConnector.csproj

@@ -0,0 +1,55 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <!--
+    WinForms WAM-broker sample. The app itself only runs on Windows because it
+    depends on net481, WinForms, and the WAM broker. We still need the project to
+    restore cleanly on Linux/macOS so the solution (.slnx) can be loaded and
+    restored in cross-platform CI; on those hosts we degrade to a no-op
+    netstandard2.0 target that builds nothing and references nothing.
+  -->
+  <PropertyGroup>
+    <TargetFramework Condition="'$(OS)' == 'Windows_NT'">net481</TargetFramework>
+    <TargetFramework Condition="'$(OS)' != 'Windows_NT'">netstandard2.0</TargetFramework>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <!-- Windows: real WinForms executable. -->
+  <PropertyGroup Condition="'$(OS)' == 'Windows_NT'">
+    <OutputType>WinExe</OutputType>
+    <RootNamespace>Microsoft.Data.SqlClient.Samples.AzureSqlConnector</RootNamespace>
+    <AssemblyName>AzureSqlConnector</AssemblyName>
+    <UseWindowsForms>true</UseWindowsForms>
+    <LangVersion>latest</LangVersion>
+    <Nullable>disable</Nullable>
+    <Platforms>AnyCPU</Platforms>
+    <GenerateAssemblyInfo>true</GenerateAssemblyInfo>
+  </PropertyGroup>
+
+  <!--
+    Non-Windows: suppress compilation entirely. Sources use WinForms APIs that
+    are not available on netstandard2.0, so we disable default compile items
+    and skip the build phase to keep `dotnet restore` / `dotnet build`
+    succeeding on Linux and macOS agents.
+  -->
+  <PropertyGroup Condition="'$(OS)' != 'Windows_NT'">
+    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
+    <NoBuild>true</NoBuild>
+    <GenerateDocumentationFile>false</GenerateDocumentationFile>
+  </PropertyGroup>
+
+  <!--
+    SqlClient project references are Windows-only. Microsoft.Data.SqlClient
+    only exposes a net462 TFM on Windows builds, so referencing it from a
+    non-Windows TFM produces NU1201. Skipping the references here keeps the
+    netstandard2.0 fallback restorable on Linux/macOS.
+
+    Pre-requisites for the Windows build:
+      1. `dotnet tool restore` must be run at the repo root.
+      2. `msbuild` should be run from the repo root so all dependencies resolve.
+  -->
+  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
+    <ProjectReference Include="..\..\..\src\Microsoft.Data.SqlClient.Extensions\Azure\src\Azure.csproj" />
+    <ProjectReference Include="..\..\..\src\Microsoft.Data.SqlClient\src\Microsoft.Data.SqlClient.csproj" />
+  </ItemGroup>
+
+</Project>

doc/apps/AzureSqlConnector/Directory.Build.props

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+
+  <!-- We purposely do not include any parent Directory.Build.props files. -->
+
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+
+</Project>

doc/apps/AzureSqlConnector/Directory.Packages.props

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+
+  <!-- We purposely do not include any parent Directory.Packages.props files. -->
+
+  <PropertyGroup>
+    <!-- Pin to a SqlClient version that is available on the governed feed and satisfies the >=7.0.2 requirement of Microsoft.Data.SqlClient.Extensions.Azure 1.0.0. -->
+    <SqlClientVersion>7.1.0-preview1.26124.5</SqlClientVersion>
+
+    <!--
+      Microsoft.Data.SqlClient 7.x moved the Active Directory authentication
+      providers (including the one that drives the ActiveDirectoryInteractive
+      browser sign-in UI) into a separate package. We must reference it
+      explicitly so the providers register at startup.
+    -->
+    <AzureExtensionsVersion>1.0.0</AzureExtensionsVersion>
+    <AbstractionsExtensionsVersion>1.0.0</AbstractionsExtensionsVersion>
+  </PropertyGroup>
+
+  <!-- SqlClient Packages -->
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.Data.SqlClient" Version="$(SqlClientVersion)" />
+    <PackageVersion Include="Microsoft.Data.SqlClient.Extensions.Azure" Version="$(AzureExtensionsVersion)" />
+    <PackageVersion Include="Microsoft.Data.SqlClient.Extensions.Abstractions" Version="$(AbstractionsExtensionsVersion)" />
+  </ItemGroup>
+
+</Project>