SqlConnectionStringBuilder::Item Property (String^)

.NET Framework (current version)

Gets or sets the value associated with the specified key. In C#, this property is the indexer.

Namespace: System.Data.SqlClient
Assembly: System.Data (in System.Data.dll)

Syntax

public:
property Object^ default[
	String^ keyword
] {
	virtual Object^ get(String^ keyword) override;
	virtual void set(String^ keyword, Object^ value) override;
}

Parameters

keyword: Type: System::String^
The key of the item to get or set.

Property Value

Type: System::Object^

The value associated with the specified key.

Exceptions

Exception	Condition
ArgumentNullException	keyword is a null reference (Nothing in Visual Basic).
KeyNotFoundException	Tried to add a key that does not exist within the available keys.
FormatException	Invalid value within the connection string (specifically, a Boolean or numeric value was expected but not supplied).

Remarks

Because the SqlConnectionStringBuilder contains a fixed-size dictionary, trying to add a key that does not exist within the dictionary throws a KeyNotFoundException.

Examples

The following code, in a console application, creates a new SqlConnectionStringBuilder and adds key/value pairs to its connection string, using the Item property.

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 2.0