OdbcConnection

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

OdbcConnection イベント

パブリック イベント

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

参照

関連項目

OdbcConnection クラス
System.Data.Odbc 名前空間

その他の技術情報

データ ソースへの接続

OdbcConnection クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 OdbcConnection
    Inherits DbConnection
    Implements ICloneable

Visual Basic (使用法)

Dim instance As OdbcConnection

C#

public sealed class OdbcConnection : DbConnection,
 ICloneable

C++

public ref class OdbcConnection sealed : public
 DbConnection, ICloneable

J#

public final class OdbcConnection extends DbConnection
 implements ICloneable

JScript

public final class OdbcConnection extends
 DbConnection implements ICloneable

解説

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

OdbcConnection オブジェクトは、ODBC の環境や接続ハンドルなどのネイティブ リソースを使用します。OdbcConnection オブジェクトが適用範囲外になる前に、必ず Close または Dispose を呼び出すか、接続を Usingステートメント内に記述することによって、開いている OdbcConnection オブジェクトを明示的に閉じる必要があります。いずれも行わなかった場合、これらのネイティブ リソースの解放はガベージ コレクションで行われます。その場合、リソースの解放は直ちに実行されるわけではありません。その結果、基になるドライバでリソースが不足したり最大制限に到達してしまう場合があります。これにより、断続的なエラーが発生するようになります。たとえば、ガベージ コレクションによる削除を待っている接続が多数存在する場合に、Maximum Connections 関連のエラーが発生する場合があります。明示的に接続を閉じると、ネイティブ リソースをより効率的に使用でき、拡張性およびアプリケーション全体のパフォーマンスが向上します。

メモ
パフォーマンスの高いアプリケーションを配置するには、接続プールを有効活用する必要があります。ただし、.NET Framework ODBC 用データ プロバイダを使用する場合は、プロバイダが接続プールを自動的に管理するため、この機能を有効にする必要はありません。

OdbcCommand クラスのいずれかの Execute メソッドを実行した結果、致命的な OdbcException (SQL Server の重大度レベル 20 以上など) が発生した場合、OdbcConnection が閉じる可能性があります。ただし、ユーザーは接続を再び開いて、処理を継続できます。

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

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

使用例

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

Visual Basic

Private Sub InsertRow(ByVal
 connectionString As String)

    Dim queryString As String
 = _
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND',
 'Northwind Traders')"
    Dim command As New OdbcCommand(queryString)

    Using connection As New OdbcConnection(connectionString)
        command.Connection = connection
        connection.Open()
        command.ExecuteNonQuery()

        ' The connection is automatically closed at 
        ' the end of the Using block.
    End Using
End Sub

C#

static private void InsertRow(string
 connectionString)
{
    string queryString = 
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind
 Traders')";
    OdbcCommand command = new OdbcCommand(queryString);

    using (OdbcConnection connection = new
 OdbcConnection(connectionString))
    {
        command.Connection = connection;
        connection.Open();
        command.ExecuteNonQuery();

        // The connection is automatically closed at 
        // the end of the Using block.
    }
}

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.Odbc.OdbcConnection

スレッド セーフ

この型の 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

参照

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

OdbcConnection コンストラクタ ()

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OdbcConnection

C#

public OdbcConnection ()

C++

public:
OdbcConnection ()

J#

public OdbcConnection ()

JScript

public function OdbcConnection ()

解説

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

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

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

使用例

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

Visual Basic

Private Sub CreateOdbcConnection()

    Using connection As New OdbcConnection
        connection.ConnectionString = "Driver={Microsoft Access
 Driver (*.mdb)};DBQ=C:\Samples\Northwind.mdb"
        connection.Open()
    End Using

End Sub

C#

static private void CreateOdbcConnection()
{
    using (OdbcConnection connection = new
 OdbcConnection())
    {
        connection.ConnectionString = "Driver={Microsoft Access Driver (*.mdb)};DBQ=C:\\Samples\\Northwind.mdb";
        connection.Open();
    }
}

プラットフォーム

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

参照

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

OdbcConnection コンストラクタ (String)

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

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

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New OdbcConnection(connectionString)

C#

public OdbcConnection (
    string connectionString
)

C++

public:
OdbcConnection (
    String^ connectionString
)

J#

public OdbcConnection (
    String connectionString
)

JScript

public function OdbcConnection (
    connectionString : String
)

パラメータ

connectionString

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

解説

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

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

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

使用例

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

Visual Basic

Private Sub CreateOdbcConnection()
    Dim connectionString As String
 = "Driver={Microsoft Access Driver (*.mdb)};DBQ=C:\Samples\Northwind.mdb"

    Using connection As New OdbcConnection(connectionString)
        connection.Open()
    End Using

End Sub

C#

static private void CreateOdbcConnection()
{
    string connectionString = "Driver={Microsoft Access Driver
 (*.mdb)};DBQ=C:\\Samples\\Northwind.mdb";

    using (OdbcConnection connection = new
 OdbcConnection(connectionString))
    {
        connection.Open();
    }
}

プラットフォーム

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

参照

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

OdbcConnection コンストラクタ

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

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

参照

関連項目

OdbcConnection クラス
OdbcConnection メンバ
System.Data.Odbc 名前空間

その他の技術情報

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

OdbcConnection プロパティ

パブリック プロパティ

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

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

プロテクト プロパティ

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

参照

関連項目

OdbcConnection クラス
System.Data.Odbc 名前空間

その他の技術情報

データ ソースへの接続

OdbcConnection メソッド

パブリック メソッド

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

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

参照

関連項目

OdbcConnection クラス
System.Data.Odbc 名前空間

その他の技術情報

データ ソースへの接続

OdbcConnection メンバ

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

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

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

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

パブリック プロパティ

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

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

プロテクト プロパティ

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

パブリック メソッド

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

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

プロテクト メソッド

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

パブリック イベント

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

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

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

参照

関連項目

OdbcConnection クラス
System.Data.Odbc 名前空間

その他の技術情報

データ ソースへの接続