OleDbConnection クラス

定義

データ ソースへの開いた接続を表します。

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
type OleDbConnection = class
    inherit DbConnection
    interface IDbConnection
    interface IDisposable
    interface ICloneable
type OleDbConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
継承
OleDbConnection
継承
継承
実装

次の例では、 と を OleDbCommand 作成します OleDbConnectionOleDbConnectionが開き、 の としてConnection設定されますOleDbCommand。 次に、接続を呼び出 ExecuteNonQuery して閉じます。 これを実現するために、 ExecuteNonQuery 接続文字列と SQL INSERT ステートメントであるクエリ文字列が渡されます。

public void InsertRow(string connectionString, string insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}
Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

注釈

オブジェクトは OleDbConnection 、データ ソースへの一意の接続を表します。 クライアント/サーバー データベース システムでは、サーバーへのネットワーク接続と同じです。 ネイティブ OLE DB プロバイダーでサポートされている機能によっては、オブジェクトの一部のメソッドまたはプロパティが OleDbConnection 使用できない場合があります。

OleDbConnectionインスタンスを作成すると、すべてのプロパティが初期値に設定されます。 これらの値の一覧については、 コンストラクターを OleDbConnection 参照してください。

1 つの OleDbConnectionで複数の DataReader を開くことができます。 使用する OLE DB プロバイダーが 1 つの接続で複数の DataReader をサポートしていない場合、プロバイダーは暗黙的にそれぞれに対して追加の接続を開きます。

OleDbConnection スコープ外になった場合、閉じません。 したがって、 または Dispose を呼び出Closeすか、 ステートメント内で オブジェクトを使用して、接続を明示的にUsingOleDbConnection閉じる必要があります。

注意

ハイ パフォーマンス アプリケーションをデプロイするには、接続プールを使用する必要があります。 .NET Framework Data Provider for OLE DB を使用する場合、プロバイダーはこれを自動的に管理するため、接続プールを有効にする必要はありません。 .NET Framework Data Provider for OLE DB で接続プールを使用する方法の詳細については、「OLE DB、ODBC、Oracle 接続プール」を参照してください。

を実行OleDbCommandするメソッドによって致命的OleDbExceptionな (たとえば、重大度レベルが 20 以上のSQL Server) が生成された場合、 OleDbConnection は閉じている可能性があります。 ただし、ユーザーは接続を再び開き、続行できます。

オブジェクトのインスタンスを作成するアプリケーションでは、宣言型または命令型の OleDbConnection セキュリティ要求を設定することで、すべての直接呼び出し元と間接呼び出し元がコードに対する十分なアクセス許可を持つ必要があります。 OleDbConnection は、 オブジェクトを使用してセキュリティ要求を行 OleDbPermission います。 ユーザーは、 オブジェクトを使用 OleDbPermissionAttribute して、コードに十分なアクセス許可があることを確認できます。 ユーザーと管理者は、 Caspol.exe (コード アクセス セキュリティ ポリシー ツール) を使用して、コンピューター、ユーザー、およびエンタープライズ レベルでセキュリティ ポリシーを変更することもできます。 詳細については、「 Code Access Security and ADO.NET」を参照してください。

データ サーバーからの警告メッセージと情報メッセージの処理の詳細については、「 接続イベント」を参照してください。

注意

オブジェクトは OleDbConnection 、OLE DB プロバイダーに固有の動的プロパティの設定または取得をサポートしていません。 OLE DB プロバイダーに接続文字列で渡すことができるプロパティだけがサポートされています。

コンストラクター

OleDbConnection()

OleDbConnection クラスの新しいインスタンスを初期化します。

OleDbConnection(String)

接続文字列を指定して、OleDbConnection クラスの新しいインスタンスを初期化します。

プロパティ

CanCreateBatch

この DbConnection インスタンスが DbBatch クラスをサポートしているかどうかを示す値を取得します。

(継承元 DbConnection)
CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。

(継承元 Component)
ConnectionString

データベースを開くために使用する文字列を取得または設定します。

ConnectionTimeout

試行を終了してエラーを生成するまでの、接続の確立の試行時に待機する時間 (秒単位) を取得します。

Container

IContainer を含む Component を取得します。

(継承元 Component)
Database

現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。

DataSource

データ ソースのサーバー名またはファイル名を取得します。

DbProviderFactory

この DbProviderFactoryDbConnection を取得します。

(継承元 DbConnection)
DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。

(継承元 Component)
Provider

接続文字列の Provider= 句で指定した OLE DB プロバイダー名を取得します。

ServerVersion

クライアントが接続しているサーバーのバージョンが示された文字列を取得します。

Site

ComponentISite を取得または設定します。

(継承元 Component)
State

現在の接続の状態を取得します。

メソッド

BeginDbTransaction(IsolationLevel)

派生クラスでオーバーライドされた場合、データベース トランザクションを開始します。

(継承元 DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

データベース トランザクションを非同期に開始します。

(継承元 DbConnection)
BeginTransaction()

現在の IsolationLevel 値を使用して、データベース トランザクションを開始します。

BeginTransaction(IsolationLevel)

分離レベルを指定して、データベース トランザクションを開始します。

BeginTransactionAsync(CancellationToken)

データベース トランザクションを非同期に開始します。

(継承元 DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

データベース トランザクションを非同期に開始します。

(継承元 DbConnection)
ChangeDatabase(String)

開いている OleDbConnection の現在のデータベースを変更します。

ChangeDatabaseAsync(String, CancellationToken)

開いている接続の現在のデータベースを非同期に変更します。

(継承元 DbConnection)
Close()

データ ソースへの接続を閉じます。

CloseAsync()

データベースへの接続を非同期に閉じます。

(継承元 DbConnection)
CreateBatch()

DbBatch クラスを実装するプロバイダーのクラスの新しいインスタンスを返します。

(継承元 DbConnection)
CreateCommand()

OleDbCommand に関連付けられている OleDbConnection オブジェクトを作成し、返します。

CreateDbBatch()

派生クラスでオーバーライドされると、 クラスを実装するプロバイダーのクラスの新しいインスタンスを DbBatch 返します。

(継承元 DbConnection)
CreateDbCommand()

派生クラスでオーバーライドされた場合、現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。

(継承元 DbConnection)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
Dispose()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

(継承元 DbConnection)
Dispose()

Component によって使用されているすべてのリソースを解放します。

(継承元 Component)
Dispose(Boolean)

DbConnection によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DbConnection)
Dispose(Boolean)

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 Component)
DisposeAsync()

接続オブジェクトを非同期に破棄します。

(継承元 DbConnection)
EnlistDistributedTransaction(ITransaction)

分散トランザクションとして指定したトランザクションに参加します。

EnlistTransaction(Transaction)

分散トランザクションとして指定したトランザクションに参加します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
古い.

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetOleDbSchemaTable(Guid, Object[])

GUID によって指定したデータ ソースのスキーマ情報を、指定した制約の適用後に返します。

GetSchema()

この OleDbConnection のデータ ソースのスキーマ情報を返します。

GetSchema(String)

スキーマ名として指定した文字列を使用して、この OleDbConnection のデータ ソースのスキーマ情報を返します。

GetSchema(String, String[])

スキーマ名に指定した文字列と制限値に指定した文字列配列を使用して、この OleDbConnection のデータ ソースのスキーマ情報を返します。

GetSchemaAsync(CancellationToken)

これは GetSchema() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchema() コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchema() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

(継承元 DbConnection)
GetSchemaAsync(String, CancellationToken)

これは GetSchema(String) の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchema(String) コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchema(String) によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

(継承元 DbConnection)
GetSchemaAsync(String, String[], CancellationToken)

これは GetSchema(String, String[]) の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchema(String, String[]) コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchema(String, String[]) によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

(継承元 DbConnection)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
InitializeLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

StateChange イベントを発生させます。

(継承元 DbConnection)
Open()

ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。

OpenAsync()

Open() で指定した設定を使用してデータベース接続を開く ConnectionString の非同期バージョン。 このメソッドは、CancellationToken.None で仮想メソッド OpenAsync(CancellationToken) を呼び出します。

(継承元 DbConnection)
OpenAsync(CancellationToken)

これは Open() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークン優先できます。

既定の実装は同期 Open() コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 Open によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

返されたタスクが完了するまで DbConnection オブジェクトの他のメソッドとプロパティを呼び出さないでください。

(継承元 DbConnection)
ReleaseObjectPool()

基になる最後の接続が解放されたときに、OleDbConnection オブジェクトのプールを削除できることを示します。

ResetState()

State オブジェクトの OleDbConnection プロパティを更新します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
ToString()

Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。

(継承元 Component)

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)
InfoMessage

プロバイダーが警告メッセージまたは情報メッセージを送信したときに発生します。

StateChange

接続の状態が変化したときに発生します。

StateChange

接続の状態が変化したときに発生します。

(継承元 DbConnection)

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

ICloneable.Clone()

このメンバーの詳細については、「Clone()」をご覧ください。

IDbConnection.BeginTransaction()

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

データベース トランザクションを開始します。

IDbConnection.BeginTransaction()

データベース トランザクションを開始します。

(継承元 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

分離レベルを指定して、データベース トランザクションを開始します。

IDbConnection.BeginTransaction(IsolationLevel)

分離レベルを指定して、データベース トランザクションを開始します。

(継承元 DbConnection)
IDbConnection.CreateCommand()

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

接続に関連付けられたコマンド オブジェクトを作成し、返します。

IDbConnection.CreateCommand()

現在の接続に関連付けられた DbCommand オブジェクトを作成し、返します。

(継承元 DbConnection)

適用対象

こちらもご覧ください