OleDbConnection クラス

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

パッケージ:

System.Data.OleDb v9.0.0-preview.7.24405.7

ソース:

OleDbConnection.cs

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

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

継承

Object

MarshalByRefObject

Component

DbConnection

OleDbConnection

実装

IDbConnection ICloneable IDisposable

例

次の例では、OleDbCommand と OleDbConnectionを作成します。 OleDbConnection が開き、OleDbCommandの Connection として設定されます。 次に、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を呼び出すか、 ステートメント内 で オブジェクトを使用して、接続を明示的に閉じる必要があります。

手記

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

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

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

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

手記

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

コンストラクター

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

プロパティ

CanCreateBatch	この DbConnection インスタンスが DbBatch クラスをサポートしているかどうかを示す値を取得します。 (継承元 DbConnection)
CanRaiseEvents	コンポーネントがイベントを発生できるかどうかを示す値を取得します。 (継承元 Component)
ConnectionString	データベースを開くために使用する文字列を取得または設定します。
ConnectionTimeout	試行を終了してエラーを生成する前に接続を確立しようとしたときに待機する時間 (秒単位) を取得します。
Container	Componentを含む IContainer を取得します。 (継承元 Component)
Database	接続を開いた後に使用する現在のデータベースまたはデータベースの名前を取得します。
DataSource	データ ソースのサーバー名またはファイル名を取得します。
DbProviderFactory	この DbConnectionの DbProviderFactory を取得します。 (継承元 DbConnection)
DesignMode	Component が現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component)
Events	この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component)
Provider	接続文字列の "Provider= " 句で指定された OLE DB プロバイダーの名前を取得します。
ServerVersion	クライアントが接続されているサーバーのバージョンを含む文字列を取得します。
Site	Componentの ISite を取得または設定します。 (継承元 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()	OleDbConnectionに関連付けられた OleDbCommand オブジェクトを作成して返します。
CreateDbBatch()	派生クラスでオーバーライドされると、DbBatch クラスを実装するプロバイダーのクラスの新しいインスタンスを返します。 (継承元 DbConnection)
CreateDbCommand()	派生クラスでオーバーライドされると、現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。 (継承元 DbConnection)
CreateObjRef(Type)	リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	アンマネージド リソースの解放、解放、またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 (継承元 DbConnection)
Dispose(Boolean)	DbConnection によって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを解放します。 (継承元 DbConnection)
DisposeAsync()	接続オブジェクトを非同期的に dipose します。 (継承元 DbConnection)
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() によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。 (継承元 DbConnection)
GetSchemaAsync(String, CancellationToken)	これは、GetSchema(String)の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を受け入れることもできます。 既定の実装では、同期 GetSchema(String) 呼び出しが呼び出され、完了したタスクが返されます。 既定の実装では、既に取り消された cancellationTokenに合格した場合、取り消されたタスクが返されます。 GetSchema(String) によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。 (継承元 DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	これは、GetSchema(String, String[])の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を受け入れることもできます。 既定の実装では、同期 GetSchema(String, String[]) 呼び出しが呼び出され、完了したタスクが返されます。 既定の実装では、既に取り消された cancellationTokenに合格した場合、取り消されたタスクが返されます。 GetSchema(String, String[]) によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。 (継承元 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 によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。 返された Task が完了するまで、DbConnection オブジェクトの他のメソッドとプロパティを呼び出さないでください。 (継承元 DbConnection)
ReleaseObjectPool()	基になる最後の接続が解放されたときに、OleDbConnection オブジェクト プールを解放できることを示します。
ResetState()	OleDbConnection オブジェクトの State プロパティを更新します。
ToString()	Componentの名前 (存在する場合) を含む String を返します。 このメソッドはオーバーライドしないでください。 (継承元 Component)

イベント

Disposed	コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component)
InfoMessage	プロバイダーが警告または情報メッセージを送信するときに発生します。
StateChange	接続の状態が変更されたときに発生します。 (継承元 DbConnection)

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

ICloneable.Clone()	このメンバーの説明については、Clone()を参照してください。
IDbConnection.BeginTransaction()	データベース トランザクションを開始します。 (継承元 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	指定した分離レベルでデータベース トランザクションを開始します。 (継承元 DbConnection)
IDbConnection.CreateCommand()	現在の接続に関連付けられている DbCommand オブジェクトを作成して返します。 (継承元 DbConnection)

拡張メソッド

ConfigureAwait(IAsyncDisposable, Boolean)

非同期破棄から返されるタスクの待機を実行する方法を構成します。

こちらもご覧ください

• データ ソースへの接続