DbConnection DbConnection DbConnection DbConnection Class

定義

データベースへの接続を表します。Represents a connection to a database.

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() 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

取得または設定、接続を開くために使用する文字列。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

接続が開かれる前に、接続文字列で指定されたデータベース名または接続が開かれた後に、現在のデータベースの名前を取得します。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

接続先となるデータベース サーバーの名前を取得します。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

オブジェクトが接続されているサーバーのバージョンを表す文字列を取得します。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)

データベース トランザクションを開始します。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.

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

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

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

データベースへの接続を閉じます。Closes the connection to the database. このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。This is the preferred method of closing any open connection.

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

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

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

作成して返します、DbCommand現在の接続に関連付けられているオブジェクト。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)
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します。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. このメソッドは、仮想メソッドを呼び出すOpenAsync(CancellationToken)CancellationToken.None を使用します。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)

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

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

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

適用対象

こちらもご覧ください