Aspire.Hosting.Azure.Sql
8.0.0-preview.6.24214.1
Prefix Reserved
See the version list below for details.
dotnet add package Aspire.Hosting.Azure.Sql --version 8.0.0-preview.6.24214.1
NuGet\Install-Package Aspire.Hosting.Azure.Sql -Version 8.0.0-preview.6.24214.1
<PackageReference Include="Aspire.Hosting.Azure.Sql" Version="8.0.0-preview.6.24214.1" />
paket add Aspire.Hosting.Azure.Sql --version 8.0.0-preview.6.24214.1
#r "nuget: Aspire.Hosting.Azure.Sql, 8.0.0-preview.6.24214.1"
// Install Aspire.Hosting.Azure.Sql as a Cake Addin #addin nuget:?package=Aspire.Hosting.Azure.Sql&version=8.0.0-preview.6.24214.1&prerelease // Install Aspire.Hosting.Azure.Sql as a Cake Tool #tool nuget:?package=Aspire.Hosting.Azure.Sql&version=8.0.0-preview.6.24214.1&prerelease
Aspire.Hosting.Azure.SqlServer library
Provides extension methods and resource definitions for a .NET Aspire AppHost to configure Azure SQL Server.
Getting started
Prerequisites
- Azure subscription - create one for free
Install the package
Install the .NET Aspire Azure SQL Server Hosting library with NuGet:
dotnet add package Aspire.Hosting.Azure.SqlServer
Usage example
In the Program.cs file of AppHost
, register a SqlServer database and consume the connection using the following methods:
var sql = builder.AddSqlServer("sql")
.AsAzureSqlDatabase()
.AddDatabase("sqldata");
var myService = builder.AddProject<Projects.MyService>()
.WithReference(sql);
The WithReference
method configures a connection in the MyService
project named sqldata
. In the Program.cs file of MyService
, the sql connection can be consumed using the client library Aspire.Microsoft.Data.SqlClient:
builder.AddSqlServerClient("sqldata");
Additional documentation
- https://learn.microsoft.com/dotnet/framework/data/adonet/sql/
- https://learn.microsoft.com/dotnet/api/system.data.sqlclient.sqlconnection
- https://github.com/dotnet/aspire/tree/main/src/Components/README.md
Feedback & contributing
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Aspire.Hosting.Azure (>= 8.0.0-preview.6.24214.1)
- Aspire.Hosting.SqlServer (>= 8.0.0-preview.6.24214.1)
- Azure.Provisioning (>= 0.2.0-beta.1)
- Azure.Provisioning.Sql (>= 0.1.0-beta.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Aspire.Hosting.Azure.Sql:
Repository | Stars |
---|---|
rstropek/Samples
|
Version | Downloads | Last updated |
---|---|---|
9.0.0 | 611 | 11/12/2024 |
9.0.0-rc.1.24511.1 | 763 | 10/15/2024 |
8.2.2 | 1,534 | 10/24/2024 |
8.2.1 | 4,194 | 9/26/2024 |
8.2.0 | 7,102 | 8/29/2024 |
8.1.0 | 3,749 | 7/23/2024 |
8.0.2 | 2,663 | 6/28/2024 |
8.0.1 | 3,076 | 5/21/2024 |
8.0.0 | 155 | 5/21/2024 |
8.0.0-preview.7.24251.11 | 505 | 5/7/2024 |
8.0.0-preview.6.24214.1 | 530 | 4/23/2024 |
8.0.0-preview.5.24201.12 | 735 | 4/9/2024 |