OracleConnectionStringBuilder 類別

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

警告

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))]
[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))>]
[<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

繼承

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

屬性

TypeConverterAttribute ObsoleteAttribute

備註

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

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

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

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

OracleConnectionStringBuilder 會處理插入惡意項目的嘗試。 例如，下列程式代碼會使用預設 Item[] 屬性（以 C# 表示索引器），正確地逸出巢狀索引鍵/值組。

Dim builder As New System.Data. _
    OracleClient.OracleConnectionStringBuilder
builder("Data Source") = "OracleDemo;NewValue=Bad"
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"

警告

Microsoft不建議直接提供您的使用者名稱和密碼，因為這是不安全的模式。 可能的話，請使用更安全的驗證流程，例如 azure 資源的 受控識別，或 SQL Server Windows 驗證。

建構函式

OracleConnectionStringBuilder()	已淘汰. 初始化 OracleConnectionStringBuilder 類別的新實例。
OracleConnectionStringBuilder(String)	已淘汰. 初始化 OracleConnectionStringBuilder 類別的新實例。 提供的連接字串會提供實例內部連接信息的數據。

屬性

BrowsableConnectionString	已淘汰. 取得或設定值，這個值表示Visual Studio設計工具中是否顯示 ConnectionString 屬性。 (繼承來源 DbConnectionStringBuilder)
ConnectionString	已淘汰. 取得或設定與 DbConnectionStringBuilder相關聯的連接字串。 (繼承來源 DbConnectionStringBuilder)
Count	已淘汰. 取得包含在 ConnectionString 屬性內的目前索引鍵數目。 (繼承來源 DbConnectionStringBuilder)
DataSource	已淘汰. 取得或設定要連接的 Oracle 資料來源名稱。
Enlist	已淘汰. 取得或設定值，這個值表示集區器是否會在建立線程的目前交易內容中自動登記連接。
IntegratedSecurity	已淘汰. 取得或設定值，指出連接中是否指定「使用者標識碼」和「密碼」（false時），或目前的 Windows 帳戶認證是否用於驗證（true時）。
IsFixedSize	已淘汰. 取得值，這個值表示 OracleConnectionStringBuilder 是否有固定大小。
IsReadOnly	已淘汰. 取得值，這個值表示 DbConnectionStringBuilder 是否為唯讀。 (繼承來源 DbConnectionStringBuilder)
Item[String]	已淘汰. 取得或設定與指定索引鍵相關聯的值。 在 C# 中，此屬性是索引器。
Keys	已淘汰. 取得 ICollection，其中包含 OracleConnectionStringBuilder中的索引鍵。
LoadBalanceTimeout	已淘汰. 取得或設定連接在移除之前，連線生存在連接集區中的最短時間，以秒為單位。
MaxPoolSize	已淘汰. 取得或設定這個特定連接字串之連接集區中允許的連線數目上限。
MinPoolSize	已淘汰. 取得或設定這個特定連接字串之連接集區中允許的連線數目下限。
OmitOracleConnectionName	已淘汰. 取得或設定旗標，這個旗標可在舊版 Oracle 上啟用交易回復（在 8.1.7.4.1 之前）。
Password	已淘汰. 取得或設定 Oracle 帳戶的密碼。
PersistSecurityInfo	已淘汰. 取得或設定 Boolean 值，這個值表示如果連接已開啟或曾經處於開啟狀態，則不會傳回安全性敏感性資訊，例如密碼。
Pooling	已淘汰. 取得或設定 Boolean 值，指出連接是否會集區，或每次要求連接時，是否都會明確開啟每個連接。
Unicode	已淘汰. 取得或設定 Boolean 值，指出用戶端是否支援稍後 Oracle 用戶端中可用的 Unicode 功能，或者它是否為非 Unicode 感知。
UserID	已淘汰. 取得或設定連接到 Oracle 時要使用的使用者識別碼。
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)	已淘汰. 填入提供的 Hashtable，其中包含此 DbConnectionStringBuilder之所有屬性的相關信息。 (繼承來源 DbConnectionStringBuilder)
GetType()	已淘汰. 取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	已淘汰. 建立目前 Object的淺層複本。 (繼承來源 Object)
Remove(String)	已淘汰. 從 OracleConnectionStringBuilder 實例中移除具有指定索引鍵的專案。
ShouldSerialize(String)	已淘汰. 指出指定的索引鍵是否存在於這個 OracleConnectionStringBuilder 實例中。
ToString()	已淘汰. 傳回與此 DbConnectionStringBuilder相關聯的連接字串。 (繼承來源 DbConnectionStringBuilder)
TryGetValue(String, Object)	已淘汰. 從這個 OracleConnectionStringBuilder擷取對應至提供之索引鍵的值。

明確介面實作

ICollection.CopyTo(Array, Int32)	已淘汰. 從特定 Array 索引開始，將 ICollection 的專案複製到 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。

另請參閱

• 建置連接字串