DbConnectionStringBuilder.Item[String] Properti

Referensi

Definisi

Ruang nama:: System.Data.Common

Rakitan:: System.Data.Common.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll

Sumber:: DbConnectionStringBuilder.cs

Sumber:: DbConnectionStringBuilder.cs

Sumber:: DbConnectionStringBuilder.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public virtual object this[string keyword] { get; set; }

[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : obj with get, set

Default Public Overridable Property Item(keyword As String) As Object

Parameter

keyword: String

Kunci item untuk mendapatkan atau mengatur.

Nilai Properti

Object

Nilai yang terkait dengan kunci yang ditentukan. Jika kunci yang ditentukan tidak ditemukan, mencoba mendapatkannya mengembalikan referensi null (Nothing di Visual Basic), dan mencoba mengaturnya membuat elemen baru menggunakan kunci yang ditentukan.

Meneruskan kunci null (Nothing di Visual Basic) melempar .ArgumentNullException Menetapkan nilai null akan menghapus pasangan kunci/nilai.

Atribut: BrowsableAttribute

Pengecualian

ArgumentNullException

keyword adalah referensi null (Nothing dalam Visual Basic).

NotSupportedException

Properti diatur, dan DbConnectionStringBuilder bersifat baca-saja.

-atau-

Properti diatur, keyword tidak ada dalam koleksi, dan DbConnectionStringBuilder memiliki ukuran tetap.

Contoh

Aplikasi konsol berikut membuat baru DbConnectionStringBuilder dan menambahkan pasangan kunci/nilai ke string koneksi-nya, menggunakan Item[] properti .

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";

    // Note that Item is the indexer, so
    // you do not include it in the reference.
    builder["integrated security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Overwrite the existing value for the Data Source key,
    // because it already exists within the collection.
    builder["Data Source"] = ".";

    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

Module Module1

    Sub Main()
        Dim builder As New DbConnectionStringBuilder
        builder.Item("Data Source") = "(local)"

        ' Item is the default property, so 
        ' you need not include it in the reference.
        builder("integrated security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the data source value, 
        ' because it already exists within the collection.
        builder.Item("Data Source") = "."

        Console.WriteLine(builder.ConnectionString)
        Console.WriteLine()
        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    End Sub

Keterangan

Saat Anda mengatur properti ini, jika kunci yang ditentukan sudah ada dalam kamus, nilai diganti; jika tidak, elemen baru dibuat.

Berlaku untuk