Aracılığıyla paylaş

SqlConnectionStringBuilder.Item[String] Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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.

Şunlara uygulanır

Ayrıca bkz.