ErikEJ.SqlClient.Extensions 0.1.2-alpha

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
.NET 6.0
This is a prerelease version of ErikEJ.SqlClient.Extensions.

Requires NuGet 5.0 or higher.

dotnet add package ErikEJ.SqlClient.Extensions --version 0.1.2-alpha
NuGet\Install-Package ErikEJ.SqlClient.Extensions -Version 0.1.2-alpha
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ErikEJ.SqlClient.Extensions" Version="0.1.2-alpha" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ErikEJ.SqlClient.Extensions --version 0.1.2-alpha
#r "nuget: ErikEJ.SqlClient.Extensions, 0.1.2-alpha"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install ErikEJ.SqlClient.Extensions as a Cake Addin
#addin nuget:?package=ErikEJ.SqlClient.Extensions&version=0.1.2-alpha&prerelease

// Install ErikEJ.SqlClient.Extensions as a Cake Tool
#tool nuget:?package=ErikEJ.SqlClient.Extensions&version=0.1.2-alpha&prerelease

Microsoft.Data.SqlClient is the open source .NET data provider for Microsoft SQL Server. It allows you to connect and interact with SQL Server and Azure SQL Database using .NET.

This package helps set up SqlClient in applications using dependency injection, notably ASP.NET and Worker Service applications. It allows easy configuration of your database connections and registers the appropriate services in your DI container. It also enables you to log events from Microsoft.Data.SqlClient using standard .NET logging (ILogger).

For example, if using the ASP.NET minimal web API, simply use the following to register Microsoft.Data.SqlClient:

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSqlDataSource("Server=.\\SQLEXPRESS;Database=Northwind;Integrated Security=true;Trust Server Certificate=true");

This registers a transient SqlConnection which can get injected into your controllers:

app.MapGet("/", async (SqlConnection connection) =>
{
    await connection.OpenAsync();
    await using var command = new SqlCommand("SELECT TOP 1 SupplierID FROM Suppliers", connection);
    return "Hello World: " + await command.ExecuteScalarAsync();
});

But wait! If all you want is to execute some simple SQL, just use the singleton SqlDataSource to execute a command directly:

app.MapGet("/", async (SqlDataSource dataSource) =>
{
    await using var command = dataSource.CreateCommand("SELECT TOP 1 SupplierID FROM Suppliers");
    return "Hello World: " + await command.ExecuteScalarAsync();
});

SqlDataSource can also come in handy when you need more than one connection:

app.MapGet("/", async (SqlDataSource dataSource) =>
{
    await using var connection1 = await dataSource.OpenConnectionAsync();
    await using var connection2 = await dataSource.OpenConnectionAsync();
    // Use the two connections...
});

The AddSqlDataSource method also enables logging of Microsoft.Data.SqlClient activity in your ASP.NET Core app.

By default informational messages are logged, this can be configured via logging configuration:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft.Data.SqlClient": "Warning"
    }
  }
}

You can also disable SqlClient logging completely like this:

   builder.Services.AddSqlDataSource("Server=.\\SQLEXPRESS;Database=Northwind;Integrated Security=true;Trust Server Certificate=true", setupAction =>
   {
       setupAction.UseLoggerFactory(null);
   });

And you can turn on full logging like this:

   builder.Services.AddSqlDataSource("Server=.\\SQLEXPRESS;Database=Northwind;Integrated Security=true;Trust Server Certificate=true", setupAction =>
   {
       setupAction.EnableVerboseLogging();
   });

For more information, see the SqlClient documentation.

Product Versions
.NET net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.1.2-alpha 266 8/6/2022
0.1.1-alpha 52 8/3/2022

Added .NET 6 support