SqlConnectionStringBuilder.Item[String] Egenskap

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.SqlClient.dll
Sammansättning:
System.Data.dll
Källa:
System.Data.SqlClient.notsupported.cs

Hämtar eller anger värdet som är associerat med den angivna nyckeln. I C# är den här egenskapen indexeraren.

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

Parametrar

keyword
String

Nyckeln för objektet som ska hämtas eller anges.

Egenskapsvärde

Object

Värdet som är associerat med den angivna nyckeln.

Undantag

ArgumentNullException

keyword är en nullreferens (Nothing i Visual Basic).

KeyNotFoundException

Försökte lägga till en nyckel som inte finns inom de tillgängliga nycklarna.

FormatException

Ogiltigt värde i reťazec pripojenia (specifikt förväntades ett booleskt eller numeriskt värde men angavs inte).

Exempel

Följande kod i ett konsolprogram skapar en ny SqlConnectionStringBuilder och lägger till nyckel/värde-par i dess reťazec pripojenia med egenskapen Item[].

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

Kommentarer

Eftersom innehåller SqlConnectionStringBuilder en ordlista med fast storlek genererar ett försök att lägga till en nyckel som inte finns i ordlistan en KeyNotFoundException.

Gäller för

Se även