OleDbConnection

.NET Framework クラス ライブラリ リファレンス

OleDbConnection イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
	InfoMessage	プロバイダが警告メッセージまたは情報メッセージを送信したときに発生します。
	StateChange	イベントの状態が変更したときに発生します。 ( DbConnection から継承されます。)

参照

関連項目

OleDbConnection クラス
System.Data.OleDb 名前空間

その他の技術情報

データ ソースへの接続

OleDbConnection クラス

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

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 OleDbConnection
    Inherits DbConnection
    Implements ICloneable, IDbConnection, IDisposable

Visual Basic (使用法)

Dim instance As OleDbConnection

C#

public sealed class OleDbConnection : DbConnection,
 ICloneable, IDbConnection, IDisposable

C++

public ref class OleDbConnection sealed : public
 DbConnection, ICloneable, IDbConnection, IDisposable

J#

public final class OleDbConnection extends
 DbConnection implements ICloneable, IDbConnection, 
    IDisposable

JScript

public final class OleDbConnection extends
 DbConnection implements ICloneable, IDbConnection, 
    IDisposable

解説

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

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

OleDbConnection は、適用範囲外では閉じられません。そのため、Close または Dispose を呼び出すか、OleDbConnection オブジェクトを Using ステートメント内に記述することによって、明示的に接続を閉じる必要があります。

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

OleDbCommand を実行したメソッドで、致命的な OleDbException (SQL Server の重大度レベルが 20 以上など) が発生した場合は、OleDbConnection が閉じられることがあります。ただし、ユーザーが接続を再び開いて、処理を継続できます。

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

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

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

使用例

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

Visual Basic

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

C#

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.
    }

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
    }

    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.
        }

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.OleDb.OleDbConnection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OleDbConnection メンバ
System.Data.OleDb 名前空間
その他の技術情報
データ ソースへの接続

OleDbConnection コンストラクタ ()

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

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OleDbConnection

C#

public OleDbConnection ()

C++

public:
OleDbConnection ()

J#

public OleDbConnection ()

JScript

public function OleDbConnection ()

解説

OleDbConnection の新しいインスタンスを作成すると、読み書き可能プロパティは、ConnectionString プロパティのキーワードを関連付けて設定した場合を除いて、次の初期値に設定されます。

プロパティ	初期値
ConnectionString	空の文字列 ("")
ConnectionTimeout	15
Database	空の文字列 ("")
DataSource	空の文字列 ("")

これらのプロパティの値を変更するには、ConnectionString プロパティを使用する必要があります。

使用例

OleDbConnection を作成し、開く例を次に示します。

Visual Basic

Public Sub OpenConnection(ByVal
 connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Try
            connection.Open()
            Console.WriteLine("DataSource: {0} Database: {1}",
 _
                connection.DataSource, connection.Database)
        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

C#

static void OpenConnection(string
 connectionString)
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        try
        {
            connection.Open();
            Console.WriteLine("DataSource: {0} \nDatabase: {1}",
                connection.DataSource, connection.Database);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        string x = "Provider=SQLOLEDB;Data Source=(local);Initial
 Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
        OpenConnection(x);
        Console.ReadLine();
    }

    static void OpenConnection(string
 connectionString)
    {
        using (OleDbConnection connection = new
 OleDbConnection(connectionString))
        {
            try
            {
                connection.Open();
                Console.WriteLine("DataSource: {0} \nDatabase: {1}",
                    connection.DataSource, connection.Database);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            // The connection is automatically closed when the
            // code exits the using block.
        }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OleDbConnection クラス
OleDbConnection メンバ
System.Data.OleDb 名前空間
その他の技術情報
データ ソースへの接続
データ ソースへの接続

OleDbConnection コンストラクタ

OleDbConnection クラスの新しいインスタンスを初期化します。 データ ソースへの接続
オーバーロードの一覧

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

参照

関連項目

OleDbConnection クラス
OleDbConnection メンバ
System.Data.OleDb 名前空間

その他の技術情報

データ ソースへの接続
データ ソースへの接続

OleDbConnection コンストラクタ (String)

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

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New OleDbConnection(connectionString)

C#

public OleDbConnection (
    string connectionString
)

C++

public:
OleDbConnection (
    String^ connectionString
)

J#

public OleDbConnection (
    String connectionString
)

JScript

public function OleDbConnection (
    connectionString : String
)

パラメータ

connectionString

データベースを開くために使用する接続。

解説

OleDbConnection の新しいインスタンスを作成すると、読み書き可能プロパティは、ConnectionString プロパティのキーワードを関連付けて設定した場合を除いて、次の初期値に設定されます。

プロパティ	初期値
ConnectionString	connectionString
ConnectionTimeout	15
Database	空の文字列 ("")
DataSource	空の文字列 ("")

これらのプロパティの値を変更するには、ConnectionString プロパティを使用する必要があります。

使用例

OleDbConnection を作成し、開く例を次に示します。

Visual Basic

Public Sub OpenConnection(ByVal
 connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Try
            connection.Open()
            Console.WriteLine("DataSource: {0} Database: {1}",
 _
                connection.DataSource, connection.Database)
        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

C#

static void OpenConnection(string
 connectionString)
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        try
        {
            connection.Open();
            Console.WriteLine("DataSource: {0} \nDatabase: {1}",
                connection.DataSource, connection.Database);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        string x = "Provider=SQLOLEDB;Data Source=(local);Initial
 Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
        OpenConnection(x);
        Console.ReadLine();
    }

    static void OpenConnection(string
 connectionString)
    {
        using (OleDbConnection connection = new
 OleDbConnection(connectionString))
        {
            try
            {
                connection.Open();
                Console.WriteLine("DataSource: {0} \nDatabase: {1}",
                    connection.DataSource, connection.Database);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            // The connection is automatically closed when the
            // code exits the using block.
        }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OleDbConnection クラス
OleDbConnection メンバ
System.Data.OleDb 名前空間
その他の技術情報
データ ソースへの接続

OleDbConnection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionString	オーバーライドされます。 データベースを開くために使用する文字列を取得または設定します。
	ConnectionTimeout	オーバーライドされます。 接続の確立の試行を開始してから、その試行を終了してエラーを生成するまでの待機時間を取得します。
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	Database	オーバーライドされます。 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
	DataSource	オーバーライドされます。 データ ソースのサーバー名またはファイル名を取得します。
	Provider	接続文字列の Provider= 句で指定した OLE DB プロバイダ名を取得します。
	ServerVersion	オーバーライドされます。 クライアントが接続しているサーバーのバージョンが示された文字列を取得します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	State	オーバーライドされます。 接続の現在の状態を取得します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

OleDbConnection クラス
System.Data.OleDb 名前空間

その他の技術情報

データ ソースへの接続

OleDbConnection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginTransaction	オーバーロードされます。 データベース トランザクションを開始します。
	ChangeDatabase	オーバーライドされます。 開いている OleDbConnection の現在のデータベースを変更します。
	Close	オーバーライドされます。 データ ソースへの接続を閉じます。
	CreateCommand	OleDbConnection に関連付けられている OleDbCommand オブジェクトを作成し、返します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	EnlistDistributedTransaction	指定した分散トランザクションに参加します。
	EnlistTransaction	オーバーライドされます。 指定した分散トランザクションに参加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetOleDbSchemaTable	GUID によって指定したデータ ソースのスキーマ情報を、指定した制約の適用後に返します。
	GetSchema	オーバーロードされます。 オーバーライドされます。 この OleDbConnection のデータ ソースのスキーマ情報を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Open	オーバーライドされます。 ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ReleaseObjectPool	基になる最後の接続が解放されたときに、OleDbConnection オブジェクトのプールを削除できることを示します。
	ResetState	OleDbConnection オブジェクトの State プロパティを更新します。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

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

	名前	説明
	System.Data.IDbConnection.BeginTransaction	オーバーロードされます。
	System.Data.IDbConnection.CreateCommand
	System.ICloneable.Clone	このメンバの説明については、ICloneable.Clone のトピックを参照してください。

参照

関連項目

OleDbConnection クラス
System.Data.OleDb 名前空間

その他の技術情報

データ ソースへの接続

OleDbConnection メンバ

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

OleDbConnection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	OleDbConnection	オーバーロードされます。 OleDbConnection クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionString	オーバーライドされます。 データベースを開くために使用する文字列を取得または設定します。
	ConnectionTimeout	オーバーライドされます。 接続の確立の試行を開始してから、その試行を終了してエラーを生成するまでの待機時間を取得します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	Database	オーバーライドされます。 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
	DataSource	オーバーライドされます。 データ ソースのサーバー名またはファイル名を取得します。
	Provider	接続文字列の Provider= 句で指定した OLE DB プロバイダ名を取得します。
	ServerVersion	オーバーライドされます。 クライアントが接続しているサーバーのバージョンが示された文字列を取得します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	State	オーバーライドされます。 接続の現在の状態を取得します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginTransaction	オーバーロードされます。 データベース トランザクションを開始します。
	ChangeDatabase	オーバーライドされます。 開いている OleDbConnection の現在のデータベースを変更します。
	Close	オーバーライドされます。 データ ソースへの接続を閉じます。
	CreateCommand	OleDbConnection に関連付けられている OleDbCommand オブジェクトを作成し、返します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	EnlistDistributedTransaction	指定した分散トランザクションに参加します。
	EnlistTransaction	オーバーライドされます。 指定した分散トランザクションに参加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetOleDbSchemaTable	GUID によって指定したデータ ソースのスキーマ情報を、指定した制約の適用後に返します。
	GetSchema	オーバーロードされます。 オーバーライドされます。 この OleDbConnection のデータ ソースのスキーマ情報を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Open	オーバーライドされます。 ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ReleaseObjectPool	基になる最後の接続が解放されたときに、OleDbConnection オブジェクトのプールを削除できることを示します。
	ResetState	OleDbConnection オブジェクトの State プロパティを更新します。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
	InfoMessage	プロバイダが警告メッセージまたは情報メッセージを送信したときに発生します。
	StateChange	イベントの状態が変更したときに発生します。(DbConnection から継承されます。)

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

	名前	説明
	System.Data.IDbConnection.BeginTransaction	オーバーロードされます。
	System.Data.IDbConnection.CreateCommand
	System.ICloneable.Clone	このメンバの説明については、ICloneable.Clone のトピックを参照してください。

参照

関連項目

OleDbConnection クラス
System.Data.OleDb 名前空間

その他の技術情報

データ ソースへの接続