<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> <link rel="stylesheet" href="/DubUrl/assets/css/just-the-docs-default.css"> <link rel="stylesheet" href="/DubUrl/assets/css/just-the-docs-head-nav.css" id="jtd-head-nav-stylesheet"> <style id="jtd-nav-activation"> .site-nav ul li a { background-image: none; } .site-nav > ul.nav-category-list > li > button svg { transform: rotate(-90deg); } .site-nav > ul.nav-category-list > li.nav-list-item > ul.nav-list { display: block; } </style> <script src="/DubUrl/assets/js/vendor/lunr.min.js"></script> <script src="/DubUrl/assets/js/just-the-docs.js"></script> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" href="/DubUrl/uploads/favicon.ico" type="image/x-icon"> <!-- Begin Jekyll SEO tag v2.9.1 --> <title>DubUrl | Database connection URLs and schema tools for .NET.</title> <meta name="generator" content="Jekyll v4.4.1" /> <meta property="og:title" content="DubUrl" /> <meta property="og:locale" content="en" /> <meta name="description" content="Database connection URLs and schema tools for .NET." /> <meta name="twitter:description" property="og:description" content="Database connection URLs and schema tools for .NET." /> <link rel="canonical" href="https://seddryck.github.io/DubUrl/assets/css/just-the-docs-head-nav.css" /> <meta property="og:url" content="https://seddryck.github.io/DubUrl/assets/css/just-the-docs-head-nav.css" /> <meta property="og:site_name" content="DubUrl" /> <meta property="og:type" content="website" /> <meta name="twitter:card" content="summary" /> <meta name="twitter:title" content="DubUrl" /> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"WebPage","description":"Database connection URLs and schema tools for .NET.","headline":"DubUrl","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://seddryck.github.io/DubUrl/uploads/DubUrl-icon-64.png"}},"url":"https://seddryck.github.io/DubUrl/assets/css/just-the-docs-head-nav.css"}</script> <!-- End Jekyll SEO tag --> <script src="/DubUrl/assets/duburl.js" defer></script> </head> <body> <a class="skip-to-main" href="#main-content">Skip to main content</a> <svg xmlns="http://www.w3.org/2000/svg" class="d-none"> <symbol id="svg-link" viewBox="0 0 24 24"> <title>Link</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"> <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path> </svg> </symbol> <symbol id="svg-menu" viewBox="0 0 24 24"> <title>Menu</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu"> <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line> </svg> </symbol> <symbol id="svg-arrow-right" viewBox="0 0 24 24"> <title>Expand</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right"> <polyline points="9 18 15 12 9 6"></polyline> </svg> </symbol> <!-- Feather. MIT License: https://github.com/feathericons/feather/blob/master/LICENSE --> <symbol id="svg-external-link" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-external-link"> <title id="svg-external-link-title">(external link)</title> <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line> </symbol> <symbol id="svg-doc" viewBox="0 0 24 24"> <title>Document</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file"> <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline> </svg> </symbol> <symbol id="svg-search" viewBox="0 0 24 24"> <title>Search</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search"> <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </symbol> <!-- Bootstrap Icons. MIT License: https://github.com/twbs/icons/blob/main/LICENSE.md --> <symbol id="svg-copy" viewBox="0 0 16 16"> <title>Copy</title> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard" viewBox="0 0 16 16"> <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1v-1z"/> <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3z"/> </svg> </symbol> <symbol id="svg-copied" viewBox="0 0 16 16"> <title>Copied</title> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard-check-fill" viewBox="0 0 16 16"> <path d="M6.5 0A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3Zm3 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3Z"/> <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1A2.5 2.5 0 0 1 9.5 5h-3A2.5 2.5 0 0 1 4 2.5v-1Zm6.854 7.354-3 3a.5.5 0 0 1-.708 0l-1.5-1.5a.5.5 0 0 1 .708-.708L7.5 10.793l2.646-2.647a.5.5 0 0 1 .708.708Z"/> </svg> </symbol> </svg> <header class="side-bar"> <div class="site-header"> <a href="/DubUrl/" class="site-title lh-tight"> <div class="site-logo" role="img" aria-label="DubUrl"></div> </a> <button id="menu-button" class="site-button btn-reset" aria-label="Menu" aria-expanded="false"> <svg viewBox="0 0 24 24" class="icon" aria-hidden="true"><use xlink:href="#svg-menu"></use></svg> </button> </div> <nav aria-label="Main" id="site-nav" class="site-nav"> <ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/" class="nav-list-link">Home</a></li><li class="nav-list-item"><a href="/DubUrl/download/" class="nav-list-link">Downloads</a></li><li class="nav-list-item"><a href="/DubUrl/brand-colors/" class="nav-list-link">Branding</a></li></ul> <div class="nav-category">Documentation</div> <ul class="nav-list"><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Getting started submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/DubUrl/docs/getting-started/" class="nav-list-link">Getting started</a><ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/docs/why-duburl/" class="nav-list-link">What is DubUrl?</a></li><li class="nav-list-item"><a href="/DubUrl/docs/choose-installation/" class="nav-list-link">Choose your installation</a></li><li class="nav-list-item"><a href="/DubUrl/docs/installation-duburl/" class="nav-list-link">Install the .NET library</a></li><li class="nav-list-item"><a href="/DubUrl/docs/first-connection/" class="nav-list-link">Your first database connection</a></li><li class="nav-list-item"><a href="/DubUrl/docs/first-schema/" class="nav-list-link">Your first schema workflow</a></li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Connecting to databases submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/DubUrl/docs/connection-schemes/" class="nav-list-link">Connecting to databases</a><ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/docs/choose-provider/" class="nav-list-link">Choose a database provider</a></li><li class="nav-list-item"><a href="/DubUrl/docs/installation-ado-net-provider/" class="nav-list-link">Configure and register your provider</a></li><li class="nav-list-item"><a href="/DubUrl/docs/connection-options/" class="nav-list-link">Authentication and connection options</a></li><li class="nav-list-item"><a href="/DubUrl/docs/connection-source/" class="nav-list-link">Reuse connections and transactions</a></li><li class="nav-list-item"><a href="/DubUrl/docs/optional-configuration/" class="nav-list-link">Required and optional configuration</a></li><li class="nav-list-item"><a href="/DubUrl/connection-configuration/" class="nav-list-link">Connection encryption and defaults</a></li><li class="nav-list-item"><a href="/DubUrl/docs/odbc-driver-locators/" class="nav-list-link">Connect through ODBC</a></li><li class="nav-list-item"><a href="/DubUrl/docs/read-only-connections/" class="nav-list-link">Read-only connections</a></li><li class="nav-list-item"><a href="/DubUrl/docs/oledb-provider-locators/" class="nav-list-link">Connect through OLE DB</a></li><li class="nav-list-item"><a href="/DubUrl/docs/adomd-providers/" class="nav-list-link">Connect to Analysis Services</a></li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Querying data submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/DubUrl/docs/dotnet-api/" class="nav-list-link">Querying data</a><ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/docs/first-query/" class="nav-list-link">Execute your first query</a></li><li class="nav-list-item"><a href="/DubUrl/docs/read-scalars/" class="nav-list-link">Read scalar values</a></li><li class="nav-list-item"><a href="/DubUrl/docs/read-rows/" class="nav-list-link">Read one or many rows</a></li><li class="nav-list-item"><a href="/DubUrl/docs/sql-templates/" class="nav-list-link">Use SQL templates</a></li><li class="nav-list-item"><a href="/DubUrl/docs/dapper/" class="nav-list-link">Use Dapper</a></li><li class="nav-list-item"><a href="/DubUrl/docs/dbreader/" class="nav-list-link">Use DbReader</a></li><li class="nav-list-item"><a href="/DubUrl/docs/dependency-injection/" class="nav-list-link">Dependency injection</a></li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Working with schemas submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/DubUrl/docs/schemas/" class="nav-list-link">Working with schemas</a><ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/docs/schema-overview/" class="nav-list-link">Overview and workflow</a></li><li class="nav-list-item"><a href="/DubUrl/docs/write-schema/" class="nav-list-link">Write a schema document</a></li><li class="nav-list-item"><a href="/DubUrl/docs/validate-schema/" class="nav-list-link">Validate a schema</a></li><li class="nav-list-item"><a href="/DubUrl/docs/generate-sql/" class="nav-list-link">Generate SQL</a></li><li class="nav-list-item"><a href="/DubUrl/docs/deploy-schema/" class="nav-list-link">Deploy a schema safely</a></li><li class="nav-list-item"><a href="/DubUrl/schema-model/" class="nav-list-link">Build schemas in C#</a></li><li class="nav-list-item"><a href="/DubUrl/docs/customize-schema/" class="nav-list-link">Customize validation and conversion</a></li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Tools and automation submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/DubUrl/docs/integrations/" class="nav-list-link">Tools and automation</a><ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/cli/" class="nav-list-link">Command-line tool</a></li><li class="nav-list-item"><a href="/DubUrl/docs/json-rpc-worker/" class="nav-list-link">JSON-RPC worker</a></li><li class="nav-list-item"><a href="/DubUrl/docs/worker-python/" class="nav-list-link">Call the worker from Python</a></li><li class="nav-list-item"><a href="/DubUrl/docs/automate-schemas/" class="nav-list-link">Automate schema deployment</a></li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Reference submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/DubUrl/docs/reference/" class="nav-list-link">Reference</a><ul class="nav-list"><li class="nav-list-item"><a href="/DubUrl/docs/basics-connection-url/" class="nav-list-link">Connection URL syntax</a></li><li class="nav-list-item"><a href="/DubUrl/docs/native-ado-net-providers/" class="nav-list-link">Supported databases and aliases</a></li><li class="nav-list-item"><a href="/DubUrl/schema-documents/" class="nav-list-link">Schema document format</a></li><li class="nav-list-item"><a href="/DubUrl/docs/class-connectionUrl/" class="nav-list-link">ConnectionUrl API</a></li><li class="nav-list-item"><a href="/DubUrl/docs/class-databaseUrl/" class="nav-list-link">DatabaseUrl API</a></li><li class="nav-list-item"><a href="/DubUrl/docs/connection-source-reference/" class="nav-list-link">Connection source API</a></li><li class="nav-list-item"><a href="/DubUrl/schema-application-api/" class="nav-list-link">Schema application API</a></li></ul></li><li class="nav-list-item"><a href="/DubUrl/cli-authentication/" class="nav-list-link">CLI authentication</a></li><li class="nav-list-item"><a href="/DubUrl/authentication/" class="nav-list-link">Library authentication</a></li><li class="nav-list-item"><a href="/DubUrl/docs/adbc-providers/" class="nav-list-link">ADBC providers</a></li><li class="nav-list-item"><a href="/DubUrl/docs/connection-string-to-url/" class="nav-list-link">Convert a connection string to a URL</a></li><li class="nav-list-item"><a href="/DubUrl/docs/schema-inspection/" class="nav-list-link">Inspect and export database schemas</a></li><li class="nav-list-item"><a href="/DubUrl/docs/provider-packs/" class="nav-list-link">Installable provider packs</a></li><li class="nav-list-item"><a href="/DubUrl/docs/provider-assembly-boundaries/" class="nav-list-link">Provider assembly boundaries</a></li><li class="nav-list-item"><a href="/DubUrl/docs/provider-modules/" class="nav-list-link">Register provider modules</a></li></ul> </nav> <div class="d-md-block d-none site-footer"> <p class="sidebar-caption">Database tools for .NET<br><a href="/DubUrl/contributing/">Contributing</a></p> </div> </header> <div class="main" id="top"> <div id="main-header" class="main-header"> <div class="search" role="search"> <div class="search-input-wrap"> <input type="text" id="search-input" class="search-input" tabindex="0" placeholder="Search DubUrl docs" autocomplete="off"> <label for="search-input" class="search-label"> <span class="sr-only">Search DubUrl docs</span> <svg viewBox="0 0 24 24" class="search-icon" aria-hidden="true"><use xlink:href="#svg-search"></use></svg> </label> </div> <div id="search-results" class="search-results"></div> </div> <nav aria-label="Auxiliary" class="aux-nav"> <ul class="aux-nav-list"> <li class="aux-nav-list-item"> <a href="https://github.com/Seddryck/DubUrl" class="site-button" > GitHub </a> </li> </ul> </nav> </div> <div class="main-content-wrap"> <div id="main-content" class="main-content"> <main> <header class="page-header"> <h1 class="page-title"> </h1> </header> </main> <hr> <footer> <p><a href="#top" id="back-to-top">Back to top</a></p> <p class="text-small mb-0">DubUrl · Database tools for .NET · <a href="https://github.com/Seddryck/DubUrl/blob/main/LICENSE">Apache 2.0</a></p> <div class="d-md-none mt-4 fs-2"> <p class="sidebar-caption">Database tools for .NET<br><a href="/DubUrl/contributing/">Contributing</a></p> </div> </footer> </div> </div> <div class="search-overlay"></div> </div> </body> </html>
