OracleConnectionStringBuilder.Item[String] 屬性

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

取得或設定與指定之索引鍵相關聯的值。 在 C# 中，這個屬性是索引子 (Indexer)。

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 為 null 參考 (在 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。 下表列出 連接字串 內的所有可能索引鍵，以及每個索引鍵的預設值。

Key	屬性	預設值
數據源 (或伺服器)	DataSource	空字串
保存安全性資訊 (或 persistsecurityinfo)	PersistSecurityInfo	否
整合式安全性	IntegratedSecurity	否
用戶標識碼 (或使用者或 uid)	UserID	空字串
密碼	Password	空字串
Enlist	Enlist	是
Pooling	Pooling	是
Min Pool Size	MinPoolSize	0
Max Pool Size	MaxPoolSize	100
省略 Oracle 連線名稱	OmitOracleConnectionName	否
Unicode	Unicode	否
負載平衡逾時 (或連線存留期)	LoadBalanceTimeout	0

另請參閱

• 建置連接字串