DbConnection クラス

定義

データベース接続のコア動作を定義し、データベース専用の接続の基底クラスを提供します。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から継承する場合は、Close()BeginDbTransaction(IsolationLevel)ChangeDatabase(String)CreateDbCommand()Open()、および StateChangeの各メンバーをオーバーライドする必要があります。When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. また、ConnectionStringDatabaseDataSourceServerVersion、および Stateの各プロパティも指定する必要があります。You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

コンストラクター

DbConnection()

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

プロパティ

CanRaiseEvents

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

(継承元 Component)
ConnectionString

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

ConnectionTimeout

試行を終了してエラーを生成するまでの、接続の確立時に待機する時間 (秒単位) を取得します。Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

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

(継承元 Component)
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

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

DbProviderFactory

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

DesignMode

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

(継承元 Component)
Events

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

(継承元 Component)
ServerVersion

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

Site

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

(継承元 Component)
State

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

メソッド

BeginDbTransaction(IsolationLevel)

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

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

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

BeginTransaction()

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

BeginTransaction(IsolationLevel)

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

BeginTransactionAsync(CancellationToken)

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

BeginTransactionAsync(IsolationLevel, CancellationToken)

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

ChangeDatabase(String)

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

ChangeDatabaseAsync(String, CancellationToken)

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

Close()

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

CloseAsync()

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

CreateCommand()

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

CreateDbCommand()

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

CreateObjRef(Type)

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

(継承元 MarshalByRefObject)
Dispose()
Dispose(Boolean)
DisposeAsync()

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

EnlistTransaction(Transaction)

指定したトランザクションに参加します。Enlists in the specified transaction.

Equals(Object)

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

(継承元 Object)
GetHashCode()

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

(継承元 Object)
GetLifetimeService()

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

(継承元 MarshalByRefObject)
GetSchema()

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

GetSchema(String)

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

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)

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

(継承元 Component)
GetType()

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

(継承元 Object)
InitializeLifetimeService()

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

(継承元 MarshalByRefObject)
MemberwiseClone()

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

(継承元 Object)
MemberwiseClone(Boolean)

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

(継承元 MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

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

Open()

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

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)

これは 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()

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

(継承元 Component)

イベント

Disposed

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

(継承元 Component)
StateChange

接続の状態が変化したときに発生します。Occurs when the state of the connection changes.

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

IDbConnection.BeginTransaction()

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

IDbConnection.BeginTransaction(IsolationLevel)

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

IDbConnection.CreateCommand()

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

適用対象

こちらもご覧ください