DbConnectionStringBuilder.ConnectionString Propiedad
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í.
Obtiene o establece la cadena de conexión asociada a .DbConnectionStringBuilder
public:
property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };public string ConnectionString { get; set; }member this.ConnectionString : string with get, setPublic Property ConnectionString As StringValor de propiedad
La cadena de conexión actual, creada a partir de los pares clave-valor contenidos en .DbConnectionStringBuilder El valor predeterminado es una cadena vacía.
Excepciones
Se ha proporcionado un argumento de cadena de conexión no válido.
Ejemplos
En el ejemplo siguiente se muestran posibles comportamientos de la ConnectionString propiedad . El ejemplo:
Crea una cadena de conexión agregando pares clave-valor, de uno en uno, a un vacío DbConnectionStringBuilder.
Asigna una cadena de conexión completa a la ConnectionString propiedad de la DbConnectionStringBuilder instancia y modifica un único par clave-valor dentro de la cadena.
Asigna un conjunto arbitrario de pares clave-valor a la ConnectionString propiedad (es decir, una cadena que no es nada de forma remota como una cadena de conexión) y modifica uno de los valores.
Asigna una cadena de conexión no válida a la ConnectionString propiedad , que muestra la excepción que se produce.
Nota:
En este ejemplo se incluye una contraseña para demostrar cómo DbConnectionStringBuilder funciona con cadenas de conexión. En las aplicaciones, se recomienda usar la autenticación de Windows. Si debe usar una contraseña, no incluya una contraseña codificada de forma rígida en la aplicación.
static void Main()
{
// Create a new DbConnctionStringBuilder, and add items
// to the internal collection of key/value pairs.
DbConnectionStringBuilder builder = new
DbConnectionStringBuilder();
builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
builder.Add("Jet OLEDB:System Database",
@"c:\MyData\Workgroup.mdb");
// Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1);
// Display the contents of the connection string, which
// will now contain all the key/value pairs delimited with
// semicolons.
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Clear the DbConnectionStringBuilder, and assign a complete
// connection string to it, to demonstrate how
// the class parses connection strings.
builder.Clear();
builder.ConnectionString =
"Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI";
// The DbConnectionStringBuilder class has parsed the contents,
// so you can work with any individual key/value pair.
builder["Data Source"] = ".";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Because the DbConnectionStringBuilder class doesn't
// validate its key/value pairs, you can use this class
// to store any semicolon-delimited list. The following
// snippet places an arbitrary string into the ConnectionString
// property, changes one of the values, and then displays the
// resulting string.
builder.Clear();
builder.ConnectionString =
"Value1=10;Value2=20;Value3=30;Value4=40";
builder["Value2"] = 25;
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
builder.Clear();
try
{
// Assigning an invalid connection string
// throws an ArgumentException.
builder.ConnectionString = "xxx";
}
catch (ArgumentException)
{
Console.WriteLine("Invalid connection string.");
}
}
Sub Main()
' Create a new DbConnctionStringBuilder, and add items
' to the internal collection of key/value pairs.
Dim builder As New DbConnectionStringBuilder()
builder.Add("Data Source", "c:\MyData\MyDb.mdb")
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
builder.Add("Jet OLEDB:System Database",
"c:\MyData\Workgroup.mdb")
' Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1)
' Display the contents of the connection string, which
' will now contain all the key/value pairs delimited with
' semicolons.
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Clear the DbConnectionStringBuilder, and assign a complete
' connection string to it, to demonstrate how
' the class parses connection strings.
builder.Clear()
builder.ConnectionString =
"Data Source=(local);Initial Catalog=AdventureWorks;" &
"Integrated Security=SSPI"
' The DbConnectionStringBuilder class has parsed the contents,
' so you can work with any individual key/value pair.
builder("Data Source") = "."
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Because the DbConnectionStringBuilder class doesn't
' validate its key/value pairs, you can use this class
' to store any semicolon-delimited list. The following
' snippet places an arbitrary string into the ConnectionString
' property, changes one of the values, and then displays the
' resulting string.
builder.Clear()
builder.ConnectionString =
"Value1=10;Value2=20;Value3=30;Value4=40"
builder("Value2") = 25
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
builder.Clear()
Try
' Assigning an invalid connection string
' throws an ArgumentException.
builder.ConnectionString = "xxx"
Catch ex As ArgumentException
Console.WriteLine("Invalid connection string.")
End Try
Console.WriteLine()
Console.WriteLine("Press Enter to finish.")
Console.ReadLine()
End Sub
Comentarios
Esta propiedad devuelve una lista delimitada por punto y coma de pares clave-valor almacenados dentro de la colección mantenida por .DbConnectionStringBuilder Cada par contiene la clave y el valor, separados por un signo igual. En el ejemplo siguiente se muestra una cadena de conexión típica.
"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"
Los proveedores de datos pueden esperar claves y valores específicos para cada propiedad de cadena de conexión. , estos valores se documentan individualmente. La DbConnectionStringBuilder clase no valida los pares clave-valor asociados a su cadena de conexión, aunque las clases que heredan de ella pueden.
La ConnectionString propiedad de la DbConnectionStringBuilder clase actúa generalmente como mecanismo para crear y analizar listas delimitadas por punto y coma de pares clave-valor separados con signos iguales. No proporciona ninguna validación u otra compatibilidad específica de las cadenas de conexión. Si agrega elementos a la DbConnectionStringBuilder colección, la ConnectionString propiedad reflejará los cambios. Si asigna un valor a la ConnectionString propiedad , intentará DbConnectionStringBuilder analizar el valor, utilizando los delimitadores de signo igual y punto y coma.
