OdbcConnectionStringBuilder Constructor (String)
Initializes a new instance of the OdbcConnectionStringBuilder class. The provided connection string provides the data for the instance's internal connection information.
Assembly: System.Data (in System.Data.dll)
| Exception | Condition |
|---|---|
| ArgumentException |
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.
Note
|
|---|
|
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() { try { // Build an empty instance, just to see // the contents of the keys. DumpBuilderContents(""); // 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."); Console.ReadLine(); } catch (System.ArgumentException ex) { Console.WriteLine("Error: " + ex.Message); } } private static void DumpBuilderContents(string connectString) { OdbcConnectionStringBuilder builder = new OdbcConnectionStringBuilder(connectString); Console.WriteLine("================="); Console.WriteLine("Original connectString = " + connectString); Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString); foreach (string key in builder.Keys) { Console.WriteLine(key + "=" + builder[key].ToString()); } } }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note