OdbcConnectionStringBuilder Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase OdbcConnectionStringBuilder.
Sobrecargas
OdbcConnectionStringBuilder() |
Inicializa una nueva instancia de la clase OdbcConnectionStringBuilder. |
OdbcConnectionStringBuilder(String) |
Inicializa una nueva instancia de la clase OdbcConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia. |
OdbcConnectionStringBuilder()
Inicializa una nueva instancia de la clase OdbcConnectionStringBuilder.
public:
OdbcConnectionStringBuilder();
public OdbcConnectionStringBuilder ();
Public Sub New ()
Consulte también
Se aplica a
OdbcConnectionStringBuilder(String)
Inicializa una nueva instancia de la clase OdbcConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia.
public:
OdbcConnectionStringBuilder(System::String ^ connectionString);
public OdbcConnectionStringBuilder (string? connectionString);
public OdbcConnectionStringBuilder (string connectionString);
new System.Data.Odbc.OdbcConnectionStringBuilder : string -> System.Data.Odbc.OdbcConnectionStringBuilder
Public Sub New (connectionString As String)
Parámetros
- connectionString
- String
Base para la información de conexión interna del objeto. Se analiza en pares de clave/valor.
Excepciones
El formato de la cadena de conexión no es correcto (quizás falte el signo "=" necesario en un par de clave/valor).
Ejemplos
En el ejemplo siguiente se crean varias OdbcConnectionStringBuilder instancias, pasando un cadena de conexión diferente al constructor en cada caso. Tenga en cuenta que el orden de los elementos dentro del cadena de conexión se puede modificar al recuperar la ConnectionString propiedad . Tenga en cuenta también que las claves que no sean las claves predefinidas "Dsn" y "Driver" se convierten en minúsculas por la OdbcConnectionStringBuilder clase .
Nota
Este ejempo incluye una contraseña para demostrar cómo OdbcConnectionStringBuilder funciona con cadenas de conexión. Se recomienda que utilice autenticación de Windows en sus aplicaciones. Si necesita utilizar una contraseña en su aplicación, no incluya una contraseña codificada de forma rígida.
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());
}
}
}
Imports System.Data.Odbc
Module Module1
Sub 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 ex As System.ArgumentException
Console.WriteLine("Error: " & ex.Message)
End Try
End Sub
Private Sub DumpBuilderContents(ByVal connectString As String)
Dim builder As New OdbcConnectionStringBuilder(connectString)
Console.WriteLine("=================")
Console.WriteLine("Original connectString = " & connectString)
Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
For Each key As String In builder.Keys
Console.WriteLine(key & "=" & builder.Item(key).ToString)
Next
End Sub
End Module
Comentarios
Puede pasar un cadena de conexión en el constructor o puede establecer la ConnectionString propiedad explícitamente. El comportamiento es el mismo de cualquier manera.