OdbcConnectionStringBuilder.Item[String] Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość skojarzona z określonym kluczem. W języku C#ta właściwość jest indeksatorem.
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, set
Default Public Overrides Property Item(keyword As String) As Object
Parametry
- keyword
- String
Klucz elementu do pobrania lub ustawienia.
Wartość właściwości
Wartość skojarzona z określonym kluczem.
Wyjątki
Parametry połączenia jest niepoprawnie sformatowana (być może brakuje wymaganego ciągu "=" w parze klucz/wartość).
keyword
jest odwołaniem o wartości null (Nothing
w Visual Basic).
Przykłady
Poniższy kod w aplikacji konsolowej tworzy nową parę OdbcConnectionStringBuilder klucz/wartość do jej parametry połączenia przy użyciu Item[] właściwości .
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
Uwagi
Po ustawieniu tej właściwości, jeśli określony klucz już istnieje w słowniku, wartość zostanie zamieniona; w przeciwnym razie zostanie utworzony nowy element.