OdbcConnectionStringBuilder.Item[String] 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 el valor asociado a la clave especificada. En C#, esta propiedad es el indizador.
public:
virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };public override object this[string keyword] { get; set; }member this.Item(string) : obj with get, setDefault Public Overrides Property Item(keyword As String) As ObjectParámetros
- keyword
- String
Clave del elemento que se va a obtener o establecer.
Valor de propiedad
Valor asociado a la clave especificada.
Excepciones
El formato de la cadena de conexión no es correcto (quizás falte el signo "=" necesario en un par de clave/valor).
keyword es una referencia nula (Nothing en Visual Basic).
Ejemplos
El siguiente código, en una aplicación de consola, crea una nueva OdbcConnectionStringBuilder y agrega pares clave-valor a sus cadenas de conexión, utilizando la propiedad Item[].
using System.Data.Odbc;
class Program
{
static void Main()
{
OdbcConnectionStringBuilder builder =
new OdbcConnectionStringBuilder();
// Set up a connection string for a text file.
builder["Driver"] = "Microsoft Text Driver (*.txt; *.csv)";
builder["dbq"] = "C:\\TextFilesFolder";
builder["Extension"] = "asc,csv,tab,txt";
// Overwrite the existing value for the dbq value,
// because it already exists within the collection.
builder["dbq"] = "D:\\";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
}
Imports System.Data.Odbc
Module Module1
Sub Main()
Dim builder As New OdbcConnectionStringBuilder
' Set up a connection string for a text file.
builder.Item("Driver") = "Microsoft Text Driver (*.txt; *.csv)"
' Note that Item is the default property, so
' you need not include it in the reference.
builder("dbq") = "C:\TextFilesFolder"
builder.Item("Extension") = "asc,csv,tab,txt"
' Overwrite the existing value for the dbq value,
' because it already exists within the collection.
builder.Item("dbq") = "D:\"
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
End Sub
End Module
Comentarios
Al establecer esta propiedad, si la clave especificada ya existe en el diccionario, el valor se reemplaza; de lo contrario, se crea un nuevo elemento.
