SqlConnectionStringBuilder.Item[String] Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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 ama sağlanmadı).

Örnekler

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

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

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.