EntityConnection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
概念モデルとデータ ソース接続への参照が含まれています。 このクラスは継承できません。
public ref class EntityConnection sealed : System::Data::Common::DbConnectionpublic sealed class EntityConnection : System.Data.Common.DbConnectiontype EntityConnection = class
inherit DbConnectionPublic NotInheritable Class EntityConnection
Inherits DbConnection- 継承
注釈
System.Data.Common.CommandTreesやObjectContextなどのオブジェクトが誤ってメタデータと同期しないようにするには、メタデータをロックEntityConnection必要があります。 メタデータがロックされた後、接続文字列に対する変更は許可されません。 メタデータがロックされる 2 つのシナリオを次に示します。
EntityConnection インスタンスは、パラメーターなしのコンストラクター、または接続文字列を受け入れる EntityConnection(String) コンストラクターを介して構築されます。 どちらの場合も、接続が開かれる前に、接続文字列が複数回変更される可能性があります。 OpenまたはGetMetadataWorkspaceを呼び出すと、メタデータがロックされます。
EntityConnection インスタンスは、EntityConnection(MetadataWorkspace, DbConnection)とMetadataWorkspaceを受け入れるDbConnection コンストラクターを介して構築されます。 この場合、メタデータは構築時にロックされます。 接続文字列への変更は許可されません。
メタデータが読み込まれると、 EntityConnection は概念モデル、ストレージ モデル、およびマッピング ファイルがすべて存在することを確認します。
コード例については、「 EntityClient の使用」を参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| EntityConnection() |
EntityConnection クラスの新しいインスタンスを初期化します。 |
| EntityConnection(MetadataWorkspace, DbConnection) |
指定したEntityConnectionとMetadataWorkspaceを使用して、DbConnection クラスの新しいインスタンスを初期化します。 |
| EntityConnection(String) |
接続文字列に基づいて、EntityConnection クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| CanRaiseEvents |
コンポーネントがイベントを発生できるかどうかを示す値を取得します。 (継承元 Component) |
| ConnectionString |
EntityConnection 接続文字列を取得または設定します。 |
| ConnectionTimeout |
接続を確立してから試行を終了し、エラーを生成するまでの待機時間を秒数で取得します。 |
| Container |
IContainerを含むComponentを取得します。 (継承元 Component) |
| Database |
現在のデータベースの名前、または接続を開いた後に使用されるデータベースを取得します。 |
| DataSource |
接続するデータ ソースの名前またはネットワーク アドレスを取得します。 |
| DbProviderFactory |
このDbProviderFactoryのDbConnectionを取得します。 (継承元 DbConnection) |
| DesignMode |
Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component) |
| Events |
この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component) |
| ServerVersion |
クライアントが接続されているデータ ソースのバージョンを含む文字列を取得します。 |
| Site | (継承元 Component) |
| State |
EntityConnectionが開いている場合は、基になるプロバイダーのConnectionState プロパティを取得します。 それ以外の場合、Closed を返します。 |
| StoreConnection |
EntityConnection オブジェクトによって使用される基になるデータ ソース接続へのアクセスを提供します。 |
メソッド
| 名前 | 説明 |
|---|---|
| BeginDbTransaction(IsolationLevel) |
派生クラスでオーバーライドされると、データベース トランザクションを開始します。 (継承元 DbConnection) |
| BeginTransaction() |
基になるプロバイダーを使用してトランザクションを開始します。 |
| BeginTransaction(IsolationLevel) |
基になるプロバイダーを使用して、指定した分離レベルでトランザクションを開始します。 |
| ChangeDatabase(String) |
サポートされていません。 |
| Close() |
データベースへの接続を閉じます。 |
| CreateCommand() |
ConnectionをこのEntityConnectionに設定して、EntityCommandの新しいインスタンスを作成します。 |
| CreateDbCommand() |
派生クラスでオーバーライドされると、現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。 (継承元 DbConnection) |
| CreateObjRef(Type) |
リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject) |
| EnlistTransaction(Transaction) |
この EntityConnection を指定されたトランザクションに参加させます。 |
| Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| GetMetadataWorkspace() |
このEntityConnectionに関連付けられているMetadataWorkspaceを返します。 |
| GetSchema() |
この DbConnectionのデータ ソースのスキーマ情報を返します。 (継承元 DbConnection) |
| GetSchema(String, String[]) |
この DbConnection のデータ ソースのスキーマ情報を返します。スキーマ名には指定した文字列を使用し、制限値には指定した文字列配列を使用します。 (継承元 DbConnection) |
| GetSchema(String) |
スキーマ名に指定した文字列を使用して、この DbConnection のデータ ソースのスキーマ情報を返します。 (継承元 DbConnection) |
| GetService(Type) |
ComponentまたはそのContainerによって提供されるサービスを表すオブジェクトを返します。 (継承元 Component) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
| OnStateChange(StateChangeEventArgs) |
StateChange イベントを発生させます。 (継承元 DbConnection) |
| Open() |
基になるデータ プロバイダーの |
| OpenAsync() |
Open()の非同期バージョン。ConnectionStringで指定された設定を使用してデータベース接続を開きます。 このメソッドは、CancellationToken.None で OpenAsync(CancellationToken) 仮想メソッドを呼び出します。 (継承元 DbConnection) |
| OpenAsync(CancellationToken) |
これは、 Open()の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 キャンセル トークンは必要に応じて受け入れられます。 既定の実装では、同期 Open() 呼び出しが呼び出され、完了したタスクが返されます。 既定の実装では、既に取り消された cancellationToken が渡された場合、取り消されたタスクが返されます。 Open によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。 返された Task が完了するまで、 |
| ToString() |
Stringの名前 (存在する場合) を含むComponentを返します。 このメソッドはオーバーライドしないでください。 (継承元 Component) |
イベント
| 名前 | 説明 |
|---|---|
| Disposed |
コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component) |
| StateChange |
接続の状態が変更されたときに発生します。 (継承元 DbConnection) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IDbConnection.BeginTransaction() |
データベース トランザクションを開始します。 (継承元 DbConnection) |
| IDbConnection.BeginTransaction(IsolationLevel) |
指定した分離レベルでデータベース トランザクションを開始します。 (継承元 DbConnection) |
| IDbConnection.CreateCommand() |
現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。 (継承元 DbConnection) |
