OracleConnectionStringBuilder 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
警告
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 DbConnectionStringBuilderPublic NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder- 繼承
- 屬性
範例
下列主控台應用程式會建置 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」和「密碼」( |
| 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。 |
方法
明確介面實作
擴充方法
| Cast<TResult>(IEnumerable) |
已淘汰.
將 IEnumerable 的項目轉換成指定的型別。 |
| OfType<TResult>(IEnumerable) |
已淘汰.
根據指定的型別來篩選 IEnumerable 的項目。 |
| AsParallel(IEnumerable) |
已淘汰.
啟用查詢的平行化作業。 |
| AsQueryable(IEnumerable) |
已淘汰.
將 IEnumerable 轉換成 IQueryable。 |
