DbConnectionStringBuilder::Item Property (String^)
Gets or sets the value associated with the specified key.
Assembly: System.Data (in System.Data.dll)
public: [BrowsableAttribute(false)] property Object^ default[ String^ keyword ] { virtual Object^ get(String^ keyword); virtual void set(String^ keyword, Object^ value); }
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. If the specified key is not found, trying to get it returns a null reference (Nothing in Visual Basic), and trying to set it creates a new element using the specified key.
Passing a null (Nothing in Visual Basic) key throws an ArgumentNullException. Assigning a null value removes the key/value pair.
| Exception | Condition |
|---|---|
| ArgumentNullException | keyword is a null reference (Nothing in Visual Basic). |
| NotSupportedException | The property is set, and the DbConnectionStringBuilder is read-only. -or- The property is set, keyword does not exist in the collection, and the DbConnectionStringBuilder has a fixed size. |
When you set this property, if the specified key already exists in the dictionary, the value is replaced; otherwise, a new element is created.
The following console application creates a new DbConnectionStringBuilder and adds key/value pairs to its connection string, using the Item property.
Available since 10
.NET Framework
Available since 2.0