DbConnection DbConnection DbConnection DbConnection Class

定義

データベース接続のコア動作を定義し、データベース専用の接続の基底クラスを提供します。Defines the core behavior of database connections and provides a base class for database-specific connections.

public ref class DbConnection abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
継承
派生
実装

注意 (継承者)

DbConnectionから継承する場合はBeginDbTransaction(IsolationLevel) CreateDbCommand()、、、 、Open()、、およびStateChangeの各メンバーをオーバーライドする必要があります。 ChangeDatabase(String) Close()When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. また、、、 ConnectionString DataSource Database、 、ServerVersionおよびの各プロパティも指定する必要Stateがあります。You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

コンストラクター

DbConnection() DbConnection() DbConnection() DbConnection()

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

プロパティ

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

派生クラスでオーバーライドされた場合、接続を開くために使用される文字列を取得または設定します。When overridden in a derived class, gets or sets the string used to open the connection.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

試行を中断してエラーを生成するまでの、接続の確立時に待機する時間を取得します。Gets the time to wait while establishing a connection before terminating 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

派生クラスでオーバーライドされた場合、接続が開いてから現在のデータベースの名前を取得するか、接続が開く前に接続文字列に指定されたデータベース名を取得します。When overridden in a derived class, gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

DataSource DataSource DataSource DataSource

派生クラスでオーバーライドされた場合、接続するデータベース サーバーの名前を取得します。When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

この DbProviderFactoryDbConnection を取得します。Gets the DbProviderFactory for this 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

派生クラスでオーバーライドされた場合、オブジェクトが接続しているサーバーのバージョンを表す文字列を取得します。When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site Site Site Site

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

(Inherited from Component)
State State State State

接続の状態を説明する文字列を取得します。Gets a string that describes the state of the connection.

メソッド

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

派生クラスでオーバーライドされた場合、データベース トランザクションを開始します。When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken)

データベース トランザクションを非同期に開始します。Asynchronously starts a database transaction.

BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

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

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

分離レベルを指定して、データベース トランザクションを開始します。Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken)

データベース トランザクションを非同期に開始します。Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken)

データベース トランザクションを非同期に開始します。Asynchronously begins a database transaction.

ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

派生クラスでオーバーライドされた場合、開いている接続の現在のデータベースを変更します。When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken)

開いている接続の現在のデータベースを非同期に変更します。Asynchronously changes the current database for an open connection.

Close() Close() Close() Close()

派生クラスでオーバーライドされた場合、データベースへの接続を閉じます。When overridden in a derived class, closes the connection to the database.

CloseAsync() CloseAsync() CloseAsync() CloseAsync()

データベースへの接続を非同期に閉じます。Asynchronously closes the connection to the database.

CreateCommand() CreateCommand() CreateCommand() CreateCommand()

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

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

派生クラスでオーバーライドされた場合、現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

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()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

接続オブジェクトを非同期に破棄します。Asynchronously diposes the connection object.

EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

指定したトランザクションに参加します。Enlists 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)
GetSchema() GetSchema() GetSchema() GetSchema()

この DbConnection のデータ ソースのスキーマ情報を返します。Returns schema information for the data source of this 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.

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.

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.

Open() Open() Open() Open()

派生クラスでオーバーライドされた場合、ConnectionString で指定された設定を使用してデータベース接続を開きます。When overridden in a derived class, opens a database connection with the settings specified by the ConnectionString.

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.

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.

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.

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

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

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

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

分離レベルを指定して、データベース トランザクションを開始します。Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

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

適用対象

こちらもご覧ください