SqlConnectionStringBuilder.Item[String] Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan. Di C#, properti ini adalah pengindeks.

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

Parameter

keyword

String

Kunci item untuk mendapatkan atau mengatur.

Nilai Properti

Object

Nilai yang terkait dengan kunci yang ditentukan.

Pengecualian

ArgumentNullException

keyword adalah referensi null (Nothing dalam Visual Basic).

KeyNotFoundException

Mencoba menambahkan kunci yang tidak ada di dalam kunci yang tersedia.

FormatException

Nilai tidak valid dalam string koneksi (khususnya, nilai Boolean atau numerik diharapkan tetapi tidak disediakan).

Contoh

Kode berikut, dalam aplikasi konsol, membuat baru SqlConnectionStringBuilder dan menambahkan pasangan kunci/nilai ke string koneksinya, menggunakan Item[] properti .

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder();
        builder["Data Source"] = "(local)";
        builder["Integrated Security"] = true;
        builder["Initial Catalog"] = "AdventureWorks";

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = ".";

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

Keterangan

SqlConnectionStringBuilder Karena berisi kamus ukuran tetap, mencoba menambahkan kunci yang tidak ada dalam kamus KeyNotFoundExceptionmelempar .