共用方式為


OracleConnectionStringBuilder.Item[String] 屬性

定義

取得或設定與指定之索引鍵相關聯的值。 在 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

要取得或設定之項目的索引鍵。

屬性值

與指定之索引鍵關聯的值。

例外狀況

keyword 為 null 參考 (在 Visual Basic 中為 Nothing)。

嘗試加入可用索引鍵中不存在的索引鍵。

連接字串中的無效值 (特別當必須是布林值或數值,但未提供這些值時)。

範例

主控台應用程式中的下列程式碼會建立新的 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

適用於

另請參閱