SqlConnection クラス

定義

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable

type SqlConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable

継承

DbConnection

SqlConnection

実装

ICloneable

例

次の例では、 と を SqlCommand 作成します SqlConnection。 SqlConnectionが開き、 の としてConnection設定されますSqlCommand。 次に、 を呼び出します ExecuteNonQuery。 これを実現するために、 ExecuteNonQuery には接続文字列と、Transact-SQL INSERT ステートメントであるクエリ文字列が渡されます。 コードが using ブロックを終了すると、接続は自動的に閉じられます。

using System;
using System.Data;
using Microsoft.Data.SqlClient;

namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);
        }
        private static void CreateCommand(string queryString,
            string connectionString)
        {
            using (SqlConnection connection = new SqlConnection(
                       connectionString))
            {
                SqlCommand command = new SqlCommand(queryString, connection);
                command.Connection.Open();
                command.ExecuteNonQuery();
            }
        }
    }
}

注釈

オブジェクトはSqlConnection、SQL Server データ ソースへの一意のセッションを表します。 クライアント/サーバー データベース システムでは、サーバーへのネットワーク接続と同じです。 SqlConnectionは、 および SqlCommand と共SqlDataAdapterに使用され、Microsoft SQL Server データベースに接続するときのパフォーマンスを向上させます。 サードパーティ製のSQL Server製品およびその他の OLE DB でサポートされているデータ ソースの場合は、 を使用OleDbConnectionします。

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

接続文字列内のキーワードの一覧については、「」を参照してくださいConnectionString。

が SqlConnection スコープ外になった場合、閉じられません。 したがって、 または Disposeを呼び出Closeして、接続を明示的に閉じる必要があります。 Close と Dispose は機能的に同等です。 接続プールの値Poolingが または yesにtrue設定されている場合、基になる接続は接続プールに返されます。 一方、 が または noにfalse設定されている場合Pooling、サーバーへの基になる接続は実際には閉じられます。

接続が常に閉じられるようにするには、次の using コード フラグメントに示すように、ブロック内の接続を開きます。 これにより、コードがブロックを終了すると、接続が自動的に閉じられます。

Using connection As New SqlConnection(connectionString)  
    connection.Open()  
    ' Do work here; connection closed on following line.  
End Using  

using (SqlConnection connection = new SqlConnection(connectionString))  
    {  
        connection.Open();  
        // Do work here; connection closed on following line.  
    }  

SqlExceptionが を実行するSqlCommandSqlConnectionメソッドによって生成された場合、重大度レベルが 19 以下の場合、 は開いたままです。 重大度レベルが 20 以上の場合、通常、サーバーは を SqlConnection閉じます。 ただし、ユーザーは接続を再び開き、続行できます。

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

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

コンストラクター

プロパティ

メソッド

イベント

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

適用対象