{"id":28561022,"url":"https://github.com/megabytemark/intradotnet-dapperextensions","last_synced_at":"2026-03-08T05:33:14.133Z","repository":{"id":286000424,"uuid":"959448188","full_name":"MegaByteMark/intradotnet-dapperextensions","owner":"MegaByteMark","description":"Extensions library for common Dapper behaviours","archived":false,"fork":false,"pushed_at":"2025-11-08T16:00:39.000Z","size":39,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-08T18:04:18.571Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MegaByteMark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-02T19:53:55.000Z","updated_at":"2025-06-07T09:27:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"17049638-fc1a-41c6-b64c-7afc0f8cf366","html_url":"https://github.com/MegaByteMark/intradotnet-dapperextensions","commit_stats":null,"previous_names":["megabytemark/intradotnet-dapperextensions"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MegaByteMark/intradotnet-dapperextensions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MegaByteMark%2Fintradotnet-dapperextensions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MegaByteMark%2Fintradotnet-dapperextensions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MegaByteMark%2Fintradotnet-dapperextensions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MegaByteMark%2Fintradotnet-dapperextensions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MegaByteMark","download_url":"https://codeload.github.com/MegaByteMark/intradotnet-dapperextensions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MegaByteMark%2Fintradotnet-dapperextensions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30246731,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T00:58:18.660Z","status":"online","status_checked_at":"2026-03-08T02:00:06.215Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-10T10:09:52.631Z","updated_at":"2026-03-08T05:33:10.263Z","avatar_url":"https://github.com/MegaByteMark.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IntraDotNet.DapperExtensions\nUtility library for Dapper to improve the development experience of common Dapper scenarios.\n\n## Initializing a Dependency Injectable Context Wrapper for Dapper\nFirst you need to create a context class that inherits from `DapperContext`, then implement the `GetDbConnection` function.\nThe following example uses a connection to an Sql Server database which requires installing either `System.Data.SqlClient` or `Microsoft.Data.SqlClient` depending on your target runtime, however you can use any database provider by installing the package relevant for that provider, if the provider implements the .NET Data Provider schema. [.NET Data Providers](https://learn.microsoft.com/en-us/dotnet/framework/data/adonet/data-providers)\n\n```csharp\nusing System.Data.Common;\nusing System.Data.SqlClient;\n\n//Include the DapperExtensions namespace\nusing IntraDotNet.DapperExtensions.Context;\n\nnamespace TestApp;\n\n/// \u003csummary\u003e\n/// This class is used to create a local SQL Server Dapper context.\n/// It inherits from the DapperContext class and overrides the GetDbConnection method.\n/// The GetDbConnection method creates a new SqlConnection object using the connection string\n/// provided in the DapperContextOptions.\n/// \u003c/summary\u003e\npublic class LocalSqlDapperContext : DapperContext\n{\n    public LocalSqlDapperContext() : base()\n    {\n    }\n\n    public LocalSqlDapperContext(DapperContextOptions options) : base(options)\n    {\n    }\n\n    public override DbConnection GetDbConnection()\n    {\n#pragma warning disable CS0618 // Type or member is obsolete\n        SqlConnection connection = new SqlConnection(Options.ConnectionString);\n#pragma warning restore CS0618 // Type or member is obsolete\n\n        return connection;\n    }\n}\n```\n\n## Registering the Dapper Context in Dependency Injection\n\nYou can register your Dapper context in two ways:  \n**1. Using a configuration action (like EF Core):**\n\n```csharp\ninternal class Program\n{\n    private static void Main(string[] args)\n    {\n        HostApplicationBuilder builder = Host.CreateApplicationBuilder(args);\n        builder.Configuration.AddJsonFile(\"appsettings.json\", optional: false, reloadOnChange: true);\n\n        builder.Services.AddDapperContext\u003cLocalSqlDapperContext\u003e(options =\u003e\n        {\n            options.ConnectionString = builder.Configuration.GetConnectionString(\"LocalSql\");\n        });\n\n        builder.Services.AddHostedService\u003cWorker\u003e();\n\n        IHost host = builder.Build();\n        host.Run();\n    }\n}\n```\n\n**2. Using appsettings.json and IOptions pattern:**\n\nAdd your connection string to `appsettings.json`:\n\n```json\n{\n  \"ConnectionStrings\": {\n    \"LocalSql\": \"your_connection_string\"\n  },\n  \"DapperContextOptions\": {\n    \"ConnectionString\": \"your_connection_string\"\n  }\n}\n```\n\nThen register the context using the IOptions pattern:\n\n```csharp\ninternal class Program\n{\n    private static void Main(string[] args)\n    {\n        HostApplicationBuilder builder = Host.CreateApplicationBuilder(args);\n        builder.Configuration.AddJsonFile(\"appsettings.json\", optional: false, reloadOnChange: true);\n\n        // Bind DapperContextOptions from configuration\n        builder.Services.Configure\u003cDapperContextOptions\u003e(builder.Configuration.GetSection(\"DapperContextOptions\"));\n\n        // Register context using IOptions\n        builder.Services.AddDapperContext\u003cILocalSqlDapperContext, LocalSqlDapperContext\u003e();\n\n        builder.Services.AddHostedService\u003cWorker\u003e();\n\n        IHost host = builder.Build();\n        host.Run();\n    }\n}\n```\n\n## Injecting and Using the Dapper Context\n\nThen dependency inject the DapperContext at the point it is required in your code:\n\n```csharp\nusing System.Data.Common;\nusing Microsoft.Extensions.Hosting;\nusing Dapper;\n\nnamespace TestApp;\n\npublic sealed class Worker : IHostedService, IHostedLifecycleService\n{\n    private readonly LocalSqlDapperContext _context;\n\n    public Worker(LocalSqlDapperContext context)\n    {\n        //Dependency injected here\n        _context = context;\n    }\n\n    public Task StartAsync(CancellationToken cancellationToken)\n    {\n        Console.WriteLine(\"Worker started.\");\n        return Task.CompletedTask;\n    }\n\n    public Task StopAsync(CancellationToken cancellationToken)\n    {\n        Console.WriteLine(\"Worker stopped.\");\n        return Task.CompletedTask;\n    }\n\n    public void OnStarting()\n    {\n        Console.WriteLine(\"OnStarting called.\");\n    }\n\n    public void OnStopping()\n    {\n        Console.WriteLine(\"OnStopping called.\");\n    }\n\n    public Task StartingAsync(CancellationToken cancellationToken)\n    {\n        Console.WriteLine(\"Worker starting.\");\n        return Task.CompletedTask;\n    }\n\n    public Task StartedAsync(CancellationToken cancellationToken)\n    {\n        Console.WriteLine(\"Worker started.\");\n\n        // Query executed here\n        using DbConnection connection = _context.GetDbConnection();\n        var id = connection.Query(\"SELECT 1 AS Id\").FirstOrDefault();\n\n        return Task.CompletedTask;\n    }\n\n    public Task StoppingAsync(CancellationToken cancellationToken)\n    {\n        Console.WriteLine(\"Worker stopping.\");\n        return Task.CompletedTask;\n    }\n\n    public Task StoppedAsync(CancellationToken cancellationToken)\n    {\n        Console.WriteLine(\"Worker stopped.\");\n        return Task.CompletedTask;\n    }\n}\n```\n\n**IMPORTANT**: Remember the `DbConnection` is an unmanaged resource and must be wrapped in a `using` to prevent memory leakage.\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmegabytemark%2Fintradotnet-dapperextensions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmegabytemark%2Fintradotnet-dapperextensions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmegabytemark%2Fintradotnet-dapperextensions/lists"}