EntityConnectionStringBuilder クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
EntityClient で使用される接続文字列の内容を簡単に作成および管理するための手段を提供します。
public ref class EntityConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilderpublic sealed class EntityConnectionStringBuilder : System.Data.Common.DbConnectionStringBuildertype EntityConnectionStringBuilder = class
inherit DbConnectionStringBuilderPublic NotInheritable Class EntityConnectionStringBuilder
Inherits DbConnectionStringBuilder- 継承
例
次の例では、EntityConnectionStringBuilder と SqlConnectionStringBuilder を組み合わせて使用しています。
// Specify the provider name, server and database.
string providerName = "System.Data.SqlClient";
string serverName = ".";
string databaseName = "AdventureWorks";
// Initialize the connection string builder for the
// underlying provider.
SqlConnectionStringBuilder sqlBuilder =
new SqlConnectionStringBuilder();
// Set the properties for the data source.
sqlBuilder.DataSource = serverName;
sqlBuilder.InitialCatalog = databaseName;
sqlBuilder.IntegratedSecurity = true;
// Build the SqlConnection connection string.
string providerString = sqlBuilder.ToString();
// Initialize the EntityConnectionStringBuilder.
EntityConnectionStringBuilder entityBuilder =
new EntityConnectionStringBuilder();
//Set the provider name.
entityBuilder.Provider = providerName;
// Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString;
// Set the Metadata location.
entityBuilder.Metadata = @"res://*/AdventureWorksModel.csdl|
res://*/AdventureWorksModel.ssdl|
res://*/AdventureWorksModel.msl";
Console.WriteLine(entityBuilder.ToString());
using (EntityConnection conn =
new EntityConnection(entityBuilder.ToString()))
{
conn.Open();
Console.WriteLine("Just testing the connection.");
conn.Close();
}
' Specify the provider name, server and database.
Dim providerName As String = "System.Data.SqlClient"
Dim serverName As String = "."
Dim databaseName As String = "AdventureWorks"
' Initialize the connection string builder for the
' underlying provider.
Dim sqlBuilder As New SqlConnectionStringBuilder
' Set the properties for the data source.
sqlBuilder.DataSource = serverName
sqlBuilder.InitialCatalog = databaseName
sqlBuilder.IntegratedSecurity = True
' Build the SqlConnection connection string.
Dim providerString As String = sqlBuilder.ToString
' Initialize the EntityConnectionStringBuilder.
Dim entityBuilder As New EntityConnectionStringBuilder
'Set the provider name.
entityBuilder.Provider = providerName
' Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString
' Set the Metadata location to the current directory.
entityBuilder.Metadata = "res://*/AdventureWorksModel.csdl|" & _
"res://*/AdventureWorksModel.ssdl|" & _
"res://*/AdventureWorksModel.msl"
Console.WriteLine(entityBuilder.ToString)
Using conn As EntityConnection = New EntityConnection(entityBuilder.ToString)
conn.Open()
Console.WriteLine("Just testing the connection.")
conn.Close()
End Using
注釈
接続文字列ビルダーを使用すると、開発者はこのクラスのプロパティおよびメソッドを使用することによって、正しい構文の接続文字列をプログラムで作成し、既存の接続文字列の解析や再作成を行うことができます。 接続文字列ビルダーは、既知のキーワード/値ペアに対応する厳密に型指定されたプロパティを提供します。 アプリケーションの一部として接続文字列を作成する必要がある開発者は、EntityConnectionStringBuilder クラスを使用して接続文字列を作成および変更できます。
EntityConnectionStringBuilder は、EntityConnectionStringBuilder プロパティ値として公開されている、有効なキーワード/値ペアをチェックします。
注意
基になるデータ ソースの接続文字列は、ProviderConnectionString プロパティによって提供されます。 提供されたプロバイダー接続文字列に対しては、有効なキーワード/値ペアのチェックは行われません。
コンストラクター
| EntityConnectionStringBuilder() |
EntityConnectionStringBuilder クラスの新しいインスタンスを初期化します。 |
| EntityConnectionStringBuilder(String) |
提供された接続文字列を使用して、EntityConnectionStringBuilder クラスの新しいインスタンスを初期化します。 |
プロパティ
| BrowsableConnectionString |
ConnectionString プロパティを Visual Studio デザイナーに表示するかどうかを示す値を取得または設定します。 (継承元 DbConnectionStringBuilder) |
| ConnectionString |
DbConnectionStringBuilder に関連付けられた接続文字列を取得または設定します。 (継承元 DbConnectionStringBuilder) |
| Count |
ConnectionString プロパティ内に含まれる現在のキー数を取得します。 (継承元 DbConnectionStringBuilder) |
| IsFixedSize |
EntityConnectionStringBuilder が固定サイズかどうかを示す値を取得します。 |
| IsReadOnly |
DbConnectionStringBuilder が読み取り専用かどうかを示す値を取得します。 (継承元 DbConnectionStringBuilder) |
| Item[String] |
指定されたキーに関連付けられている値を取得または設定します。 C# の場合、このプロパティはインデクサーです。 |
| Keys |
ICollection 内のキーが格納されている EntityConnectionStringBuilder を取得します。 |
| Metadata |
接続文字列内のメタデータの位置を取得または設定します。 |
| Name |
構成ファイルに定義されるセクションの名前を取得または設定します。 |
| Provider |
接続文字列の基になる.NET Framework データ プロバイダーの名前を取得または設定します。 |
| ProviderConnectionString |
内部のプロバイダー固有の接続文字列を取得または設定します。 |
| Values |
ICollection 内の値を格納している DbConnectionStringBuilder を取得します。 (継承元 DbConnectionStringBuilder) |
メソッド
明示的なインターフェイスの実装
拡張メソッド
| Cast<TResult>(IEnumerable) |
IEnumerable の要素を、指定した型にキャストします。 |
| OfType<TResult>(IEnumerable) |
指定された型に基づいて IEnumerable の要素をフィルター処理します。 |
| AsParallel(IEnumerable) |
クエリの並列化を有効にします。 |
| AsQueryable(IEnumerable) |
IEnumerable を IQueryable に変換します。 |
適用対象
こちらもご覧ください
.NET