EntityConnection EntityConnection EntityConnection EntityConnection Class

定義

概念モデルおよびデータ ソース接続への参照が含まれます。Contains a reference to a conceptual model and a data source connection. このクラスは継承できません。This class cannot be inherited.

public ref class EntityConnection sealed : System::Data::Common::DbConnection
public sealed class EntityConnection : System.Data.Common.DbConnection
type EntityConnection = class
    inherit DbConnection
Public NotInheritable Class EntityConnection
Inherits DbConnection
継承

注釈

System.Data.Common.CommandTreesObjectContext などのオブジェクトが不注意でメタデータと同期しなくなるのを防ぐため、EntityConnection でそのメタデータをロックする必要があります。To avoid inadvertently putting objects such as System.Data.Common.CommandTrees and ObjectContext out of sync with their metadata, EntityConnection must lock its metadata. メタデータがロックされると、接続文字列に変更を加えることができなくなります。No changes to the connection string are allowed after the metadata is locked. メタデータがロックされる 2 つのシナリオを次に示します。The following are two scenarios in which metadata is locked:

メタデータが読み込まれると、EntityConnection は、概念モデル、ストレージ モデル、およびマッピング ファイルがすべて存在することを確認します。When metadata is loaded, the EntityConnection verifies that the conceptual model, the storage model, and the mapping file are all present.

コード例については、次を参照してください。 EntityClient の使用します。For code examples, see Working with EntityClient.

コンストラクター

EntityConnection() EntityConnection() EntityConnection() EntityConnection()

EntityConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the EntityConnection class.

EntityConnection(MetadataWorkspace, DbConnection) EntityConnection(MetadataWorkspace, DbConnection) EntityConnection(MetadataWorkspace, DbConnection) EntityConnection(MetadataWorkspace, DbConnection)

指定した EntityConnection および MetadataWorkspace を使用して、DbConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the EntityConnection class with a specified MetadataWorkspace and DbConnection.

EntityConnection(String) EntityConnection(String) EntityConnection(String) EntityConnection(String)

接続文字列に基づいて、EntityConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the EntityConnection class, based on the connection string.

プロパティ

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

EntityConnection 接続文字列を取得または設定します。Gets or sets the EntityConnection connection string.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

接続を確立する際、試行を終了してエラーを生成するまでに待機する秒数を取得します。Gets the number of seconds to wait when attempting to establish a connection before ending the attempt and generating an error.

Container Container Container Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

現在のデータベースの名前、または接続が開かれた後に使用されるデータベースの名前を取得します。Gets the name of the current database, or the database that will be used after a connection is opened.

DataSource DataSource DataSource DataSource

接続先のデータ ソースの名前またはネットワーク アドレスを取得します。Gets the name or network address of the data source to connect to.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

この DbProviderFactoryDbConnection を取得します。Gets the DbProviderFactory for this DbConnection.

(Inherited from DbConnection)
DesignMode DesignMode DesignMode DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

クライアントが接続されているデータ ソースのバージョンを含む文字列を取得します。Gets a string that contains the version of the data source to which the client is connected.

Site Site Site Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

ConnectionState が開いている場合は、基になるプロバイダーの EntityConnection プロパティを取得します。Gets the ConnectionState property of the underlying provider if the EntityConnection is open. それ以外の場合、Closed を返します。Otherwise, returns Closed.

StoreConnection StoreConnection StoreConnection StoreConnection

EntityConnection オブジェクトで使用される、基になるデータ ソース接続へのアクセスを提供します。Provides access to the underlying data source connection that is used by the EntityConnection object.

メソッド

BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel)

データベース トランザクションを開始します。Starts a database transaction.

(Inherited from DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) Inherited from DbConnection
BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

基になるプロバイダーを使用してトランザクションを開始します。Begins a transaction by using the underlying provider.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

基になるプロバイダーを使用して、指定の分離レベルでトランザクションを開始します。Begins a transaction with the specified isolation level by using the underlying provider.

BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) Inherited from DbConnection
BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) Inherited from DbConnection
ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

サポートされていません。Not supported.

ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) Inherited from DbConnection
Close() Close() Close() Close()

データベースへの接続を閉じます。Closes the connection to the database.

CloseAsync(CancellationToken) CloseAsync(CancellationToken) CloseAsync(CancellationToken) CloseAsync(CancellationToken) Inherited from DbConnection
CreateCommand() CreateCommand() CreateCommand() CreateCommand()

EntityCommand をこの Connection に設定して、EntityConnection の新しいインスタンスを作成します。Creates a new instance of an EntityCommand, with the Connection set to this EntityConnection.

CreateDbCommand() CreateDbCommand() CreateDbCommand() CreateDbCommand()

現在の接続に関連付けられている DbCommand オブジェクトを作成し、返します。Creates and returns a DbCommand object associated with the current connection.

(Inherited from DbConnection)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose() Inherited from DbConnection
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Inherited from DbConnection
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync() Inherited from DbConnection
EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

この EntityConnection を指定されたトランザクションに登録します。Enlists this EntityConnection in the specified transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMetadataWorkspace() GetMetadataWorkspace() GetMetadataWorkspace() GetMetadataWorkspace()

この MetadataWorkspace に関連付けられている EntityConnection を返します。Returns the MetadataWorkspace associated with this EntityConnection.

GetSchema() GetSchema() GetSchema() GetSchema()

この DbConnection のデータ ソースのスキーマ情報を返します。Returns schema information for the data source of this DbConnection.

(Inherited from DbConnection)
GetSchema(String) GetSchema(String) GetSchema(String) GetSchema(String)

スキーマ名として指定した文字列を使用して、この DbConnection のデータ ソースのスキーマ情報を返します。Returns schema information for the data source of this DbConnection using the specified string for the schema name.

(Inherited from DbConnection)
GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[])

スキーマ名に指定した文字列と制限値に指定した文字列配列を使用して、この DbConnection のデータ ソースのスキーマ情報を返します。Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

(Inherited from DbConnection)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs)

StateChange イベントを発生させます。Raises the StateChange event.

(Inherited from DbConnection)
Open() Open() Open() Open()

基になるデータ プロバイダーの Open メソッドを呼び出して、データ ソースへの接続を確立します。Establishes a connection to the data source by calling the underlying data provider's Open method.

OpenAsync() OpenAsync() OpenAsync() OpenAsync()

Open() で指定した設定を使用してデータベース接続を開く ConnectionString の非同期バージョン。An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. このメソッドは、CancellationToken.None で仮想メソッド OpenAsync(CancellationToken) を呼び出します。This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

(Inherited from DbConnection)
OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken)

これは Open() の非同期バージョンです。This is the asynchronous version of Open(). プロバイダーは、適切な実装でオーバーライドする必要があります。Providers should override with an appropriate implementation. オプションで、キャンセル トークン優先できます。The cancellation token can optionally be honored.

既定の実装は同期 Open() コールを呼び出し、完了したタスクを返します。The default implementation invokes the synchronous Open() call and returns a completed task. 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Open によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。Exceptions thrown by Open will be communicated via the returned Task Exception property.

返されたタスクが完了するまで DbConnection オブジェクトの他のメソッドとプロパティを呼び出さないでください。Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Inherited from DbConnection)
ToString() ToString() ToString() ToString()

Component の名前 (存在する場合) を格納する String を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

(Inherited from Component)

イベント

Disposed Disposed Disposed Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
StateChange StateChange StateChange StateChange

イベントの状態が変更したときに発生します。Occurs when the state of the event changes.

(Inherited from DbConnection)

明示的なインターフェイスの実装

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

データベース トランザクションを開始します。Begins a database transaction.

(Inherited from DbConnection)
IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

指定した IsolationLevel 値を使用して、データベース トランザクションを開始します。Begins a database transaction with the specified IsolationLevel value.

(Inherited from DbConnection)
IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

現在の接続に関連付けられた DbCommand オブジェクトを作成し、返します。Creates and returns a DbCommand object that is associated with the current connection.

(Inherited from DbConnection)

適用対象

こちらもご覧ください