OdbcConnectionStringBuilder Constructor (String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the OdbcConnectionStringBuilder class. The provided connection string provides the data for the instance's internal connection information.

Namespace:   System.Data.Odbc
Assembly:  System.Data (in System.Data.dll)

public OdbcConnectionStringBuilder(
	string connectionString


Type: System.String

The basis for the object's internal connection information. Parsed into key/value pairs.

Exception Condition

The connection string is incorrectly formatted (perhaps missing the required "=" within a key/value pair).

You can pass a connection string in the constructor, or you can set the ConnectionString property explicitly. The behavior is the same either way.

The following example creates multiple OdbcConnectionStringBuilder instances, passing a different connection string to the constructor in each case. Note that the ordering of elements within the connection string may be modified when you retrieve the ConnectionString property. Also note that keys other than the predefined "Dsn" and "Driver" keys are converted to lowercase by the OdbcConnectionStringBuilder class.


This example includes a password to demonstrate how OdbcConnectionStringBuilder works with connection strings. In your applications, we recommend that you use Windows Authentication. If you must use a password, do not include a hard-coded password in your application.

using System.Data.Odbc;

class Program
    static void Main()
            // Build an empty instance, just to see
            // the contents of the keys.

            // Create a SQL Server connection string.
            DumpBuilderContents("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1");

            // Create an Access connection string.
            DumpBuilderContents(@"Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1");

            // Create an Oracle connection string.
            DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;");

            // Create a Sybase connection string.
            DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1");

            Console.WriteLine("Press any key to finish.");

        catch (System.ArgumentException ex)
            Console.WriteLine("Error: " + ex.Message);

    private static void DumpBuilderContents(string connectString)
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder(connectString);
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in builder.Keys)
            Console.WriteLine(key + "=" + builder[key].ToString());

.NET Framework
Available since 2.0
Return to top