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

另请参阅

• 生成连接字符串