SqlConnectionStringBuilder.Item[String] Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá nebo nastaví hodnotu přidruženou k zadanému klíči. V jazyce C# je tato vlastnost indexerem.

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

Parametry

keyword

String

Klíč položky, kterou chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Hodnota přidružená k zadanému klíči.

Výjimky

ArgumentNullException

keyword je odkaz s hodnotou null (Nothing v jazyce Visual Basic).

KeyNotFoundException

Pokusili jste se přidat klíč, který v dostupných klíčích neexistuje.

FormatException

Neplatná hodnota v rámci připojovacího řetězce (konkrétně se očekávala logická nebo číselná hodnota, ale nebyla zadána).

Příklady

Následující kód v konzolové aplikaci vytvoří nový SqlConnectionStringBuilder a pomocí vlastnosti přidá do připojovacího Item[] řetězce páry klíč/hodnota.

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

Poznámky

Vzhledem k tomu, že SqlConnectionStringBuilder obsahuje slovník s pevnou velikostí, vyvolá pokus o přidání klíče, který ve slovníku neexistuje, chybu KeyNotFoundException.