OdbcConnection クラス

[アーティクル]
03/28/2008

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

この型のすべてのメンバの一覧については、OdbcConnection メンバを参照してください。

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

NotInheritable Public Class OdbcConnection
   Inherits Component
   Implements ICloneable, IDbConnection
[C#]
public sealed class OdbcConnection : Component, ICloneable,
   IDbConnection
[C++]
public __gc __sealed class OdbcConnection : public Component,
   ICloneable, IDbConnection
[JScript]
public class OdbcConnection extends Component implements
   ICloneable, IDbConnection

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

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

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

メモパフォーマンスの高いアプリケーションを配置するには、必要に応じて接続プールを使用します。ただし、.NET Framework Data Provider for ODBC を使用する場合は、プロバイダが接続プールを自動的に管理するため、この機能を有効にする必要はありません。接続プールの有効化および無効化の詳細については、Microsoft Open Database Connectivity (ODBC) のドキュメントを参照してください。

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

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

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

使用例

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

 
Public Sub InsertRow(myConnection As String)
    ' If the connection string is null, use a default.
    If myConnection = "" Then
        myConnection = "DRIVER={SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;"
    End If
    Dim myConn As New OdbcConnection(myConnection)
    Dim myInsertQuery As String = "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
    Dim myOdbcCommand As New OdbcCommand(myInsertQuery)
    myOdbcCommand.Connection = myConn
    myConn.Open()
    myOdbcCommand.ExecuteNonQuery()
    myOdbcCommand.Connection.Close()
End Sub

[C#] 
public void InsertRow(string myConnection) 
{
   // If the connection string is null, use a default.
   if(myConnection == "") 
   {
      myConnection = "DRIVER={SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;";
   }
   OdbcConnection myConn = new OdbcConnection(myConnection);
   string myInsertQuery = "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
   OdbcCommand myOdbcCommand = new OdbcCommand(myInsertQuery);
   myOdbcCommand.Connection = myConn;
   myConn.Open();
   myOdbcCommand.ExecuteNonQuery();
   myOdbcCommand.Connection.Close();
}

[C++] 
public:
    void InsertRow(String* myConnection)
    {
        // If the connection string is null, use a default.
        if (myConnection->Equals(S""))
        {
            myConnection = S"DRIVER= {SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;";
        }
        OdbcConnection* myConn = new OdbcConnection(myConnection);
        String* myInsertQuery = S"INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
        OdbcCommand* myOdbcCommand = new OdbcCommand(myInsertQuery);
        myOdbcCommand->Connection = myConn;
        myConn->Open();
        myOdbcCommand->ExecuteNonQuery();
        myOdbcCommand->Connection->Close();
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Data.Odbc

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Data (System.Data.dll 内)

参照

OdbcConnection メンバ | System.Data.Odbc 名前空間 | OdbcDataAdapter | OdbcCommand

OdbcConnection クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース