OracleConnectionStringBuilder.ContainsKey Method (String)


Determines whether the OracleConnectionStringBuilder contains a specific key.

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

Public Overrides Function ContainsKey (
	keyword As String
) As Boolean


Type: System.String

The key to locate in the OracleConnectionStringBuilder.

Return Value

Type: System.Boolean

true if the OracleConnectionStringBuilder contains an element that has the specified key; otherwise, false.

Exception Condition

keyword is null (Nothing in Visual Basic)

Because the OracleConnectionStringBuilder contains a fixed-size collection of key/value pairs, the ContainsKey method determines only if a particular key name is valid.

The following example creates an OracleConnectionStringBuilder instance, sets some of its properties, and then tries to determine whether various keys exist within the object by calling the ContainsKey method.

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    Dim builder As _
     New OracleConnectionStringBuilder(GetConnectionString())
    Console.WriteLine("Connection string = " & builder.ConnectionString)

    ' Keys you have provided return true.
    Console.WriteLine(builder.ContainsKey("Integrated Security"))

    ' Comparison is case insensitive, and synonyms for the 
    ' keywords are translated to well-known names.
    ' The following returns True because "PWD" is a 
    ' synonym for "Password", a valid key.

    ' Keys that are valid but have not been set return true.

    ' Keys that don't exist return false.

    Console.WriteLine("Press Enter to continue.")
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True"
  End Function
End Module

.NET Framework
Available since 2.0
Return to top