OracleConnectionStringBuilder Constructor (String^)
Initializes a new instance of the OracleConnectionStringBuilder class. The provided connection string provides the data for the instance's internal connection information.
Assembly: System.Data.OracleClient (in System.Data.OracleClient.dll)
Parameters
- connectionString
-
Type:
System::String^
The basis for the object's internal connection information. Parsed into name/value pairs. Invalid key names raise a KeyNotFoundException.
| Exception | Condition |
|---|---|
| KeyNotFoundException | Invalid key name within the connection string. |
| FormatException | Invalid value within the connection string (specifically, when a Boolean or numeric value was expected but not supplied). |
The OracleConnectionStringBuilder class provides a fixed internal collection of key/value pairs. Even if you supply only a small subset of the possible connection string values in the constructor, the object always provides default values for each key/value pair. When the ConnectionString property of the object is retrieved, the string contains only key/value pairs in which the value is different from the default value for the item.
The following example supplies a simple connection string in the OracleConnectionStringBuilder object's constructor, and then iterates through all the key/value pairs within the object. Note that the collection provides default values for each items. Also note that the OracleConnectionStringBuilder class converts synonyms for the well-known keys so that they are consistent with the well-known names.
 Note |
|---|
This example includes a password to demonstrate how OracleConnectionStringBuilder works with connection strings. In your applications, we recommend that you use Windows Authentication. If you must use a password, do not include a hard-coded password in your application. |
Available since 2.0