DbConnectionStringBuilder.ConnectionString Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a cadeia de conexão associada 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 da propriedade
A cadeia de conexão atual, criada de pares chave-valor contidos dentro de DbConnectionStringBuilder. O valor padrão é uma cadeia de caracteres vazia.
Exceções
Um argumento de cadeia de conexão inválido foi fornecido.
Exemplos
O exemplo a seguir demonstra possíveis comportamentos da ConnectionString propriedade . O exemplo:
Cria um cadeia de conexão adicionando pares chave/valor, um de cada vez, a um vazioDbConnectionStringBuilder.
Atribui uma cadeia de conexão completa à ConnectionString propriedade da DbConnectionStringBuilder instância e modifica um único par chave/valor dentro da cadeia de caracteres.
Atribui um conjunto arbitrário de pares chave/valor à ConnectionString propriedade (ou seja, uma cadeia de caracteres que não é nada remotamente como um cadeia de conexão) e modifica um dos valores.
Atribui um cadeia de conexão inválido à ConnectionString propriedade , demonstrando a exceção gerada.
Observação
Este exemplo inclui uma senha para demonstrar como DbConnectionStringBuilder funciona com cadeias de conexão. Em seus aplicativos, recomendamos que você use a Autenticação do Windows. Se você precisar usar uma senha, não inclua uma senha embutida em código em seu aplicativo.
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:Database Password", "********");
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.");
}
Console.WriteLine();
Console.WriteLine("Press Enter to finish.");
Console.ReadLine();
}
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:Database Password", "*******")
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
Comentários
Essa propriedade retorna uma lista delimitada por ponto e vírgula de pares chave/valor armazenados dentro da coleção mantida pelo DbConnectionStringBuilder. Cada par contém a chave e o valor, separados por um sinal de igual. O exemplo a seguir ilustra um cadeia de conexão típico.
"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"
Os provedores de dados podem esperar chaves e valores específicos para cada propriedade cadeia de conexão. , esses valores são documentados individualmente. A DbConnectionStringBuilder classe não valida os pares chave/valor associados à sua cadeia de conexão, embora as classes que herdam dela possam.
A ConnectionString propriedade da DbConnectionStringBuilder classe atua geralmente como um mecanismo para criar e analisar listas delimitadas por ponto e vírgula de pares chave/valor separados por sinais iguais. Ele não fornece nenhuma validação ou outro suporte específico para cadeias de conexão. Se você adicionar itens à DbConnectionStringBuilder coleção, a ConnectionString propriedade refletirá as alterações. Se você atribuir um valor à ConnectionString propriedade , o DbConnectionStringBuilder tentará analisar o valor usando os delimitadores ponto e vírgula e sinal de igual.
