OleDbConnection クラス

定義

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

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, 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, IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
継承
OleDbConnection
継承
継承
実装

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

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

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

注意

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

を実行するメソッドによって致命的な (たとえば、SQL Server 重大度レベルが 20 以上) が生成された場合、 OleDbException OleDbCommand 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)
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() (継承元 DbConnection)
CreateCommand()

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

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

適用対象

こちらもご覧ください