SqlConnectionStringBuilder.Item[String] Özellik

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Kaynak:
System.Data.SqlClient.notsupported.cs

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 null başvurudur (Visual Basic Nothing).

KeyNotFoundException

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

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, konsol uygulamasında yeni bir SqlConnectionStringBuilder oluşturur ve Item[] özelliğini kullanarak bağlantı dizesi anahtar/değer çiftleri 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.

Şunlara uygulanır

Ayrıca bkz.