OleDbConnectionStringBuilder.Item[String] Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja a megadott kulccsal társított értéket. A C#-ban ez a tulajdonság az indexelő.
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 ObjectParaméterek
- keyword
- String
A lekérni vagy beállítani kívánt elem kulcsa.
Tulajdonság értéke
A megadott kulccsal társított érték.
Kivételek
A kapcsolati karakterlánc helytelenül van formázva (lehet, hogy hiányzik a szükséges "=" egy kulcs/érték páron belül).
keyword null értékű hivatkozás (Nothing Visual Basic).
Példák
Az alábbi példa a Item[] tulajdonság (az indexelő C#-ban) használatával kéri le és állítja be az értékeket a kulcs/érték párok gyűjteményében. Vegye figyelembe, hogy ebben az esetben a szolgáltató beállítása alapértelmezett értékeket is biztosít a kiválasztott szolgáltatóhoz társított kulcs-érték párokhoz.
using System.Data.OleDb;
class Program
{
static void Main()
{
OleDbConnectionStringBuilder builder = new OleDbConnectionStringBuilder();
builder.Provider = "Microsoft.Jet.Oledb.4.0";
builder.DataSource = @"C:\Sample.mdb";
// Set properties using the Item property (the indexer, in C#).
builder["Jet OLEDB:Encrypt Database"] = true;
builder["Jet OLEDB:System database"] = @"C:\Workgroup.mdw";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Use the Item property to retrieve values as well.
Console.WriteLine(builder["Jet OLEDB:System database"]);
Console.WriteLine(builder["Jet OLEDB:Encrypt Database"]);
// You can set or retrieve any of the "default" values for the
// provider, even if you didn't set their values.
Console.WriteLine(builder["Jet OLEDB:Database Locking Mode"]);
Console.WriteLine(builder["Jet OLEDB:Global Partial Bulk Ops"]);
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
}
Imports System.Data.OleDb
Module Module1
Sub Main()
Dim builder As New OleDbConnectionStringBuilder
builder.Provider = "Microsoft.Jet.Oledb.4.0"
builder.DataSource = "C:\Sample.mdb"
' Set properties using the Item property.
builder.Item("Jet OLEDB:Encrypt Database") = True
' Because Item is the default property, you can leave out
' the explicit reference.
builder("Jet OLEDB:System database") = "C:\Workgroup.mdw"
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Use the Item property to retrieve values, as well.
Console.WriteLine(builder.Item("Jet OLEDB:System database"))
Console.WriteLine(builder("Jet OLEDB:Encrypt Database"))
' You can set or retrieve any of the "default" values for the
' provider, as well, even if you did not set their values. Again,
' explicitly specifying the Item property name is optional.
Console.WriteLine(builder.Item("Jet OLEDB:Database Locking Mode"))
Console.WriteLine(builder("Jet OLEDB:Global Partial Bulk Ops"))
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
End Sub
End Module
Megjegyzések
Mivel a Provider tulajdonság beállítása megfelelő elemeket adhat hozzá a kulcs/érték párok gyűjteményéhez (az adott szolgáltató viselkedésétől függően), előfordulhat, hogy lekérheti a nem explicit módon beállított kulcs értékét. Ha például a Provider tulajdonságot "sqloledb"-ra állította be, akkor is lekérheti a "Workstation ID" értéket, ha nem saját maga állította be. Bemutatót a jelen témakörben található példában talál.
