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);
その結果、ユーザー ID 値を引用符で囲むことで、無効な値を安全な方法で処理する次の接続文字列が得られます。
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 |
古い.
"User ID" および "Password" を接続文字列中に指定するか ( |
| IsFixedSize |
古い.
OracleConnectionStringBuilder が固定サイズかどうかを示す値を取得します。 |
| IsReadOnly |
古い.
DbConnectionStringBuilder が読み取り専用かどうかを示す値を取得します。 (継承元 DbConnectionStringBuilder) |
| Item[String] |
古い.
指定されたキーに関連付けられている値を取得または設定します。 C# の場合、このプロパティはインデクサーです。 |
| 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 に変換します。 |
適用対象
こちらもご覧ください
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示