SqlConnectionStringBuilder.Item[String] Özellik

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

Belirtilen anahtarla ilişkili değeri alır veya ayarlar. C# dilinde bu özellik dizin oluşturucudur.

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

Parametreler

keyword

String

Alınacak veya ayarlanacağı öğenin anahtarı.

Özellik Değeri

Object

Belirtilen anahtarla ilişkili değer.

Özel durumlar

ArgumentNullException

keyword bir null başvurudur (Nothing Visual Basic'te).

KeyNotFoundException

Kullanılabilir anahtarlar içinde bulunmayan bir anahtar eklemeye çalıştı.

FormatException

bağlantı dizesi içinde geçersiz değer (özellikle boole değeri veya sayısal değer bekleniyordu ancak sağlanmadı).

Örnekler

Aşağıdaki kod, bir konsol uygulamasında yeni SqlConnectionStringBuilder bir oluşturur ve özelliğini kullanarak bağlantı dizesi anahtar/değer çiftleri Item[] ekler.

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

Açıklamalar

SqlConnectionStringBuilder sabit boyutlu bir sözlük içerdiğinden, sözlüğün içinde bulunmayan bir anahtar eklemeye çalışmak bir KeyNotFoundExceptionoluşturur.

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış