OracleConnectionStringBuilder.Remove(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从 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 连接名称 | 错误 |