OracleConnectionStringBuilder.Item[String] 属性

  • 参考

定义

命名空间:
System.Data.OracleClient
程序集:
System.Data.OracleClient.dll

获取或设置与指定的键关联的值。 在 C# 中，此属性为索引器。

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };
public override object this[string keyword] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overrides Property Item(keyword As String) As Object

参数

keyword
String

要获取或设置的项的键。

属性值

Object

与指定的键相关联的值。

例外

ArgumentNullException

keyword 为空引用（在 Visual Basic 中为 Nothing）。

KeyNotFoundException

尝试添加可用键中不存在的键。

FormatException

连接字符串中包含无效的值（具体而言，需要使用布尔值或数值，但字符串中并未提供）。

示例

以下代码在控制台应用程序中新建一个 OracleConnectionStringBuilder，并使用 Item[] 属性将键/值对添加到其连接字符串中。

// 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()
    {
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder();
        builder["Data Source"] = "localhost";
        builder["integrated security"] = true;
        builder["Unicode"] = true;

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = "NewOracleDemo";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        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()
    Dim builder As New OracleConnectionStringBuilder
    builder.Item("Data Source") = "OracleDemo"
    ' Item is the default property, so 
    ' you need not include it in the reference.
    builder("integrated security") = True
    builder.Item("Unicode") = True

    ' Overwrite the existing value for the Data Source value.
    builder.Item("Data Source") = "NewOracleDemo"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

注解

由于 OracleConnectionStringBuilder 包含固定大小的字典，因此如果尝试添加的键不在字典中，则会引发 KeyNotFoundException。 下表列出了连接字符串中所有可能的键，以及每个键的默认值。

键 properties 默认值
数据源 (或服务器) DataSource 空字符串
持久保存安全信息 (或 persistsecurityinfo) PersistSecurityInfo 错误
集成安全性 IntegratedSecurity 错误
用户 ID (或用户或 uid) UserID 空字符串
密码 Password 空字符串
Enlist Enlist 正确
Pooling Pooling 正确
Min Pool Size MinPoolSize 0
Max Pool Size MaxPoolSize 100
省略 Oracle 连接名称 OmitOracleConnectionName 错误
Unicode Unicode 错误
负载均衡超时 (或连接生存期) LoadBalanceTimeout 0

适用于

另请参阅