SqlConnectionStringBuilder.Item[String] Properti

Referensi

Definisi

Ruang nama:: System.Data.SqlClient

Rakitan:: System.Data.SqlClient.dll

Rakitan:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.6

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. 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 koneksi-nya, menggunakan Item[] properti .

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();
    }
}

Module Module1
    Sub Main()
        Dim builder As New SqlConnectionStringBuilder
        builder.Item("Data Source") = "(local)"
        ' Item is the default property, so 
        ' you needn't include it in the reference.
        builder("Integrated Security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the Data Source value.
        builder.Item("Data Source") = "."

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

Keterangan

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

Berlaku untuk