DataProviderParseJdbcConnectionString Method

Parses a JDBC connection string and extracts provider-specific parameter values.

Namespace:  Dundas.BI.Data.DataProviders
Assembly:  Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (25.3.0.1000)
Syntax
Copy
public virtual ParameterValueCollection ParseJdbcConnectionString(
	string jdbcConnectionString,
	IReadOnlyList<ProviderProperty>? providerProperties = null
)

Parameters

jdbcConnectionString
Type: SystemString
The JDBC connection string to parse. The string must follow the format specific to the JDBC provider, such as "jdbc:sqlserver://localhost:1433;databaseName=TestDB;user=sa;password=your_password;encrypt=true;" or "jdbc:postgresql://localhost:5432/TestDB?user=sa&password=your_password&ssl=true".
providerProperties (Optional)
Type: System.Collections.GenericIReadOnlyListProviderProperty
A list of ProviderProperty to use instead of the the provider defaults.

Return Value

Type: ParameterValueCollection
A ParameterValueCollection containing the extracted parameter values, such as host, port, database name, and any additional provider-specific parameters.
Exceptions
ExceptionCondition
ArgumentExceptionThrown if jdbcConnectionString is null, empty, or does not match the expected JDBC connection string format.
InvalidOperationExceptionThrown if the JDBC parameter separator is not defined for the provider and the connection string contains parameters.
Remarks
This method validates the format of the provided JDBC connection string and extracts key-value pairs based on the provider's expected format. If the connection string contains parameters, they are resolved against the provider's property descriptors. The last occurrence of a parameter takes precedence if duplicates are found.
See Also