共用方式為


OracleConnectionStringBuilder 類別

定義

警告

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

提供簡單的方法,以建立和管理 OracleConnection 類別使用之連接字串的內容。

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder
[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder
[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder
Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder
繼承
OracleConnectionStringBuilder
屬性

範例

下列主控台應用程式會建置 Oracle 資料庫的連接字串。 程序代碼會使用 OracleConnectionStringBuilder 類別來建立 連接字串,然後將 實例的 OracleConnectionStringBuilder 屬性傳遞ConnectionString至連接類別的建構函式。 此範例也會剖析現有的 連接字串,並示範各種操作 連接字串 內容的方式。

注意

這個範例包含了密碼,可示範 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()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}
' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

備註

此類型已被取代,將會在未來版本的 .NET Framework 中移除。 如需詳細資訊,請參閱 Oracle 和 ADO.NET

連接字串 產生器可讓開發人員以程式設計方式建立語法正確的連接字串,以及使用 類別的屬性和方法剖析和重建現有的連接字串。 連接字串 產生器會提供強型別屬性,對應至 Oracle 所允許的已知索引鍵/值組。 OracleConnectionStringBuilder 類別會實作 ICustomTypeDescriptor 介面。 這表示類別在設計時間與 Visual Studio .NET 設計工具搭配運作。 當開發人員使用設計工具在 Visual Studio .NET 內建置強型別 DataSet 和強型別連線時,強型別 連接字串 產生器類別會顯示與其類型相關聯的屬性,而且也會有轉換器來對應已知索引鍵的通用值。

必須建立連接字串做為應用程式一部分的開發人員可以使用 OracleConnectionStringBuilder 類別來建置及修改連接字串。 類別 OracleConnectionStringBuilder 也可讓您輕鬆地管理儲存在應用程式組態檔中的連接字串。

OracleConnectionStringBuilder 會執行有效索引鍵/值組的檢查。 因此,這個類別無法用來建立無效的連接字串。 嘗試新增無效的配對將會擲回例外狀況。 類別 OracleConnectionStringBuilder 會維護同義字的固定集合,而且必要時,可以執行必要的翻譯,以從同義字轉換成對應的已知索引鍵名稱。 例如,當您使用 Item[] 屬性來擷取值時,您可以指定包含所需索引鍵之任何同義字的字串。 如需可接受的完整同義資料表清單,請參閱 Item[] 屬性。

OracleConnectionStringBuilder 柄會嘗試插入惡意專案。 例如,下列程式代碼使用預設 Item[] 屬性 (索引器,在 C# ) 正確地逸出巢狀索引鍵/值組。

Dim builder As New System.Data. _  
    OracleClient.OracleConnectionStringBuilder  
builder("Data Source") = "OracleDemo"  
builder("Integrated Security") = True  
builder("User ID") = "Mary;NewValue=Bad"  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)  
System.Data.OracleClient.OracleConnectionStringBuilder builder =  
   new System.Data.OracleClient.OracleConnectionStringBuilder();  
builder["Data Source"] = "OracleDemo";  
builder["integrated Security"] = true;  
builder["User ID"] = "Mary;NewValue=Bad";  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);  

結果是下列 連接字串,以安全的方式處理無效的值,方法是以引號括住用戶標識碼:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"  

建構函式

OracleConnectionStringBuilder()
已淘汰.

初始化 OracleConnectionStringBuilder 類別的新執行個體。

OracleConnectionStringBuilder(String)
已淘汰.

初始化 OracleConnectionStringBuilder 類別的新執行個體。 所提供的連接字串會提供執行個體內部連接資訊的資料。

屬性

BrowsableConnectionString
已淘汰.

取得或設定值,指出 ConnectionString 屬性是否會顯示在 Visual Studio 設計工具中。

(繼承來源 DbConnectionStringBuilder)
ConnectionString
已淘汰.

取得或設定與 DbConnectionStringBuilder 相關聯的連接字串。

(繼承來源 DbConnectionStringBuilder)
Count
已淘汰.

取得 ConnectionString 屬性內所包含的索引鍵目前數目。

(繼承來源 DbConnectionStringBuilder)
DataSource
已淘汰.

取得或設定要連接之 Oracle 資料來源的名稱。

Enlist
已淘汰.

取得或設定值,指示共用器是否在建立執行緒的目前交易內容中自動登記連接。

IntegratedSecurity
已淘汰.

取得或設定值,指示是否在連接中指定「使用者 ID」和「密碼」(false 時) 或目前 Windows 帳戶認證是否用於驗證 (true 時)。

IsFixedSize
已淘汰.

取得值,指出 OracleConnectionStringBuilder 是否有固定的大小。

IsReadOnly
已淘汰.

取得值,這個值表示 DbConnectionStringBuilder 是否為唯讀。

(繼承來源 DbConnectionStringBuilder)
Item[String]
已淘汰.

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

Keys
已淘汰.

取得 ICollection 中包含索引鍵的 OracleConnectionStringBuilder

LoadBalanceTimeout
已淘汰.

取得或設定在移除之前,連接在連接集區中存在的最短時間 (以秒為單位)。

MaxPoolSize
已淘汰.

取得或設定連接集區中,針對這個特定的連接字串允許的最大連接數目。

MinPoolSize
已淘汰.

取得或設定連接集區中,針對這個特定的連接字串允許的最小連接數目。

OmitOracleConnectionName
已淘汰.

取得或設定旗號,以啟用在先前版本 Oracle (8.1.7.4.1 之前) 中的交易復原。

Password
已淘汰.

取得或設定 Oracle 帳戶的密碼。

PersistSecurityInfo
已淘汰.

取得或設定布林值,指出連接開啟或曾經處於開啟狀態時,是否將敏感的安全性資訊 (如密碼) 當做連接的一部分傳回。

Pooling
已淘汰.

取得或設定布林值,指示每次要求連接時,是否緩衝或是否明確開啟每一連接。

Unicode
已淘汰.

取得或設定布林值,指示用戶端是否支援以後版本 Oracle 用戶端中可用的 Unicode 功能,或者其是否感知非 Unicode。

UserID
已淘汰.

取得或設定連接至 Oracle 時要使用的使用者 ID。

Values
已淘汰.

取得包含 ICollection 中之值的 OracleConnectionStringBuilder

方法

Add(String, Object)
已淘汰.

將有指定索引鍵和數值項目加入 DbConnectionStringBuilder 中。

(繼承來源 DbConnectionStringBuilder)
Clear()
已淘汰.

清除 OracleConnectionStringBuilder 執行個體的內容。

ClearPropertyDescriptors()
已淘汰.

清除在相關聯 DbConnectionStringBuilder 上的 PropertyDescriptor 物件集合。

(繼承來源 DbConnectionStringBuilder)
ContainsKey(String)
已淘汰.

判斷 OracleConnectionStringBuilder 是否包含特定索引鍵。

Equals(Object)
已淘汰.

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
EquivalentTo(DbConnectionStringBuilder)
已淘汰.

比較在這個 DbConnectionStringBuilder 物件中的連接資訊和提供之物件中的連接資訊。

(繼承來源 DbConnectionStringBuilder)
GetHashCode()
已淘汰.

做為預設雜湊函式。

(繼承來源 Object)
GetProperties(Hashtable)
已淘汰.

以這個 DbConnectionStringBuilder 之所有屬性的相關資訊填滿提供的 Hashtable

(繼承來源 DbConnectionStringBuilder)
GetType()
已淘汰.

取得目前執行個體的 Type

(繼承來源 Object)
MemberwiseClone()
已淘汰.

建立目前 Object 的淺層複製。

(繼承來源 Object)
Remove(String)
已淘汰.

OracleConnectionStringBuilder 執行個體移除具有指定之索引鍵的項目。

ShouldSerialize(String)
已淘汰.

指出這個 OracleConnectionStringBuilder 執行個體中,是否存在指定的索引鍵。

ToString()
已淘汰.

傳回與這個 DbConnectionStringBuilder 相關聯的連接字串。

(繼承來源 DbConnectionStringBuilder)
TryGetValue(String, Object)
已淘汰.

從這個 OracleConnectionStringBuilder 擷取對應到所提供之索引鍵的值。

明確介面實作

ICollection.CopyTo(Array, Int32)
已淘汰.

從特定的 ICollection 索引開始,將 Array 的項目複製到 Array

(繼承來源 DbConnectionStringBuilder)
ICollection.IsSynchronized
已淘汰.

取得值,這個值表示對 ICollection 的存取是否同步 (安全執行緒)。

(繼承來源 DbConnectionStringBuilder)
ICollection.SyncRoot
已淘汰.

取得可用以同步存取 ICollection 的物件。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()
已淘汰.

傳回元件之這個執行個體的自訂屬性集合。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()
已淘汰.

傳回這個元件執行個體的類別名稱。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()
已淘汰.

傳回這個元件執行個體的名稱。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()
已淘汰.

傳回這個元件執行個體的類型轉換子。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()
已淘汰.

傳回這個元件執行個體的預設事件。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()
已淘汰.

傳回這個元件執行個體的屬性。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)
已淘汰.

傳回元件的這個執行個體之指定類型編輯器。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()
已淘汰.

傳回這個元件執行個體的事件。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])
已淘汰.

使用指定屬性陣列做為篩選條件傳回元件之執行個體的事件。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()
已淘汰.

傳回元件之這個執行個體的屬性。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])
已淘汰.

使用屬性陣列做為篩選條件,傳回這個元件執行個體的屬性。

(繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)
已淘汰.

傳回物件,包含指定的屬性描述項所描述的屬性。

(繼承來源 DbConnectionStringBuilder)
IDictionary.Add(Object, Object)
已淘汰.

將隨附有索引鍵和值的項目加入至 IDictionary 物件。

(繼承來源 DbConnectionStringBuilder)
IDictionary.Contains(Object)
已淘汰.

判斷 IDictionary 物件是否包含具有指定索引鍵的項目。

(繼承來源 DbConnectionStringBuilder)
IDictionary.GetEnumerator()
已淘汰.

傳回 IDictionary 物件的 IDictionaryEnumerator 物件。

(繼承來源 DbConnectionStringBuilder)
IDictionary.Item[Object]
已淘汰.

取得或設定具有指定索引鍵的項目。

(繼承來源 DbConnectionStringBuilder)
IDictionary.Remove(Object)
已淘汰.

IDictionary 物件中移除具有指定索引鍵的項目。

(繼承來源 DbConnectionStringBuilder)
IEnumerable.GetEnumerator()
已淘汰.

傳回逐一查看集合的列舉值。

(繼承來源 DbConnectionStringBuilder)

擴充方法

Cast<TResult>(IEnumerable)
已淘汰.

IEnumerable 的項目轉換成指定的型別。

OfType<TResult>(IEnumerable)
已淘汰.

根據指定的型別來篩選 IEnumerable 的項目。

AsParallel(IEnumerable)
已淘汰.

啟用查詢的平行化作業。

AsQueryable(IEnumerable)
已淘汰.

IEnumerable 轉換成 IQueryable

適用於

另請參閱