OracleConnectionStringBuilder.Remove(String) 方法

定义

OracleConnectionStringBuilder 实例中移除具有指定的键的项。

public:
 override bool Remove(System::String ^ keyword);
public override bool Remove (string keyword);
override this.Remove : string -> bool
Public Overrides Function Remove (keyword As String) As Boolean

参数

keyword
String

要从此 OracleConnectionStringBuilder 中的连接字符串移除的键/值对中的键。

返回

如果该键原本存在于连接字符串中但被移除,则为 true;如果连接字符串中不存在该键,则为 false

例外

keyword 为 null(在 Visual Basic 中为 Nothing)。

示例

以下示例将现有连接字符串从使用 Windows 身份验证转换为使用集成安全性。 该示例通过以下方式来完成此工作:从连接字符串中移除用户名和密码,然后设置 IntegratedSecurity 对象的 OracleConnectionStringBuilder 属性。

注意

该示例包括一个密码以演示 OracleConnectionStringBuilder 如何使用连接字符串。 在您的应用程序中,建议使用 Windows 身份验证。 如果必须使用密码,请不要在你的应用程序中包括硬编码的密码。

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=OracleDemo;User ID=Mary;Password=*****";

            OracleConnectionStringBuilder builder = 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 (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}
' 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

注解

Remove由于 方法返回一个值,该值指示其成功,因此在尝试从OracleConnectionStringBuilder实例中删除键/值对之前,无需查找是否存在键。 OracleConnectionStringBuilder由于 维护键/值对的固定大小集合,因此调用 Remove 方法只是将键/值对的值重置回其默认值。

由于 OracleConnectionStringBuilder 所支持的键集合是固定的,因此该集合中的每一项都具有已知的默认值。

下表列出了键,以及第一次初始化 时 OracleConnectionStringBuilder 或调用 方法后 Remove 每个键的值:

默认值
数据源 空字符串
持久性安全信息 错误
集成安全性 错误
用户 ID 空字符串
密码 空字符串
Enlist 正确
Pooling 正确
Min Pool Size 0
Max Pool Size 100
Unicode 错误
Load Balance Timeout 0
省略 Oracle 连接名称 错误

适用于

另请参阅