Removes the entry with the specified key from the OracleConnectionStringBuilder instance.
Assembly: System.Data.OracleClient (in System.Data.OracleClient.dll)
Return ValueType: System.Boolean
true if the key existed within the connection string and was removed, false if the key did not exist.
Because the method returns a value that indicates its success, it is not necessary to look for the existence of a key before trying to remove the key/value pair from the OracleConnectionStringBuilder instance. Because the OracleConnectionStringBuilder maintains a fixed-size collection of key/value pairs, calling the method just resets the value of the key/value pair back to its default value.
Because the collection of keys supported by the OracleConnectionStringBuilder is fixed, every item within the collection has a known default value.
The following table lists the keys, and the value for each when the OracleConnectionStringBuilder is first initialized, or after the method has been called:
Persist Security Info
Min Pool Size
Max Pool Size
Load Balance Timeout
Omit Oracle Connection Name
The following example converts an existing connection string from using Windows Authentication to using integrated security. The example works by removing the user name and password from the connection string, and then setting the IntegratedSecurity property of the OracleConnectionStringBuilder object.
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.
' 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() Try Dim connectString As String = _ "Data Source=OracleDemo;User ID=Mary;Password=*****;" Dim builder As New OracleConnectionStringBuilder(connectString) Console.WriteLine("Original: " & builder.ConnectionString) ' Use the Remove method ' in order to reset the user ID and password back to their ' default (empty string) values. builder.Remove("User ID") builder.Remove("Password") ' Turn on integrated security. builder.IntegratedSecurity = True Console.WriteLine("Modified: " & builder.ConnectionString) Catch ex As Exception Console.WriteLine(ex.Message) End Try Console.WriteLine("Press any key to finish.") Console.ReadLine() End Sub End Module
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2