SqlConnectionとは?

Weblio辞書

初めての方へ

参加元一覧


用語解説|動画|商品|全文検索

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

マイクロソフトマイクロソフト

SqlConnection イベント


パブリック イベントパブリック イベント

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

SqlConnection クラス

SQL Server データベースへの開いた接続を表します。このクラス継承できません。

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

Public NotInheritable Class
 SqlConnection
    Inherits DbConnection
    Implements ICloneable
Dim instance As SqlConnection
public sealed class SqlConnection : DbConnection,
 ICloneable
public ref class SqlConnection sealed : public
 DbConnection, ICloneable
public final class SqlConnection extends DbConnection
 implements ICloneable
public final class SqlConnection extends
 DbConnection implements ICloneable
解説解説

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

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

SqlConnection は、適用範囲の外では開いたままになります。そのためClose または Dispose呼び出して、明示的接続を閉じる必要があります。CloseDispose機能は同じです。接続プールPoolingtrue または yes設定されている場合、基になる接続接続プールに返されます。一方Poolingfalse または no設定されている場合サーバーへの基になる接続実際に閉じられます。

接続を常に閉じた状態にしておくには、次のコード片に示すように、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.
    }
メモメモ

パフォーマンスの高いアプリケーション配置するには、接続プール使用する必要があります。.NET Framework SQL Serverデータ プロバイダ使用するときは、プロバイダ接続プール自動的管理するため、接続プールを有効にする必要はありません。ただし、その場合でも、一部設定変更できます。詳細については、「接続プール使用」を参照してください

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

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

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

使用例使用

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

Private Sub OpenSqlConnection()
    Dim connectionString As String
 = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Private Function GetConnectionString() As
 String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;"
 _
      & "Integrated Security=SSPI;"
End Function
private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file, using the 
    // System.Configuration.ConfigurationSettings.AppSettings property
 
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlClient.SqlConnection
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlConnection コンストラクタ ()

SqlConnection クラス新しインスタンス初期化します。

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

Dim instance As New SqlConnection
public SqlConnection ()
public:
SqlConnection ()
public SqlConnection ()
public function SqlConnection ()
解説解説

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

プロパティ

初期値

ConnectionString

の文字列 ("")

ConnectionTimeout

15

Database

の文字列 ("")

DataSource

の文字列 ("")

これらのプロパティの値を変更するには、ConnectionString プロパティ使用する必要があります。SqlConnectionStringBuilder クラス使用すると、接続文字列内容作成管理効率よく行うことができます。

使用例使用

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

Private Sub OpenSqlConnection()
    Dim connectionString As String
 = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Private Function GetConnectionString() As
 String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;"
 _
      & "Integrated Security=SSPI;"
End Function
private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file, using the 
    // System.Configuration.ConfigurationSettings.AppSettings property
 
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlConnection コンストラクタ (String)

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

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

Public Sub New ( _
    connectionString As String _
)
Dim connectionString As String

Dim instance As New SqlConnection(connectionString)
public SqlConnection (
    string connectionString
)
public:
SqlConnection (
    String^ connectionString
)
public SqlConnection (
    String connectionString
)
public function SqlConnection (
    connectionString : String
)

パラメータ

connectionString

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

解説解説

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

プロパティ

初期値

ConnectionString

connectionString

ConnectionTimeout

15

Database

の文字列 ("")

DataSource

の文字列 ("")

これらのプロパティの値を変更するには、ConnectionString プロパティ使用する必要があります。SqlConnection クラス使用すると、接続文字列内容作成管理効率よく行うことができます。

使用例使用

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

Private Sub OpenSqlConnection()
    Dim connectionString As String
 = GetConnectionString()

    Using connection As New SqlConnection(connectionString)

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}",
 _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As
 String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;"
 _
      & "Integrated Security=SSPI;"
End Function
private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file, using the 
    // System.Configuration.ConfigurationSettings.AppSettings property
 
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlConnection コンストラクタ

SqlConnection クラス新しインスタンス初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
SqlConnection () SqlConnection クラス新しインスタンス初期化します。

.NET Compact Framework によってサポートされています。

SqlConnection (String) 接続文字列を示す文字列を指定して、SqlConnection クラス新しインスタンス初期化します。

.NET Compact Framework によってサポートされています。

参照参照

SqlConnection プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ参照)
  名前 説明
パブリック プロパティ ConnectionString オーバーライドされます。 SQL Server データベースを開くために使用する文字列取得または設定します。
パブリック プロパティ ConnectionTimeout オーバーライドされます。 接続確立試行開始してから、その試行終了してエラー生成するまでの待機時間取得します。
パブリック プロパティ Container  Component格納している IContainer取得します。 ( Component から継承されます。)
パブリック プロパティ Database オーバーライドされます。 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
パブリック プロパティ DataSource オーバーライドされます。 接続する SQL Serverインスタンスの名前を取得します。
パブリック プロパティ ServerVersion オーバーライドされます。 クライアント接続している SQL Serverインスタンスバージョンを示す文字列を取得します。
パブリック プロパティ Site  ComponentISite取得または設定します。 ( Component から継承されます。)
パブリック プロパティ State オーバーライドされます。 SqlConnection の状態を示します。
パブリック プロパティ WorkstationId データベース クライアント識別する文字列取得します。
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ CanRaiseEvents  コンポーネントイベント発生させることがきかどうかを示す値を取得します。 ( Component から継承されます。)
プロテクト プロパティ DesignMode  Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
プロテクト プロパティ Events  Component に結び付けられているイベント ハンドラリスト取得します。 ( Component から継承されます。)
参照参照

SqlConnection メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド参照)
  名前 説明
パブリック メソッド BeginTransaction オーバーロードされます。 データベース トランザクション開始します。
パブリック メソッド ChangeDatabase オーバーライドされます。 開いている SqlConnection の現在のデータベース変更します。
パブリック メソッド ChangePassword 接続文字列中に指定されているユーザーSQL Server パスワードを、指定された新しパスワード変更します。
パブリック メソッド ClearAllPools 接続プールを空にします。
パブリック メソッド ClearPool 指定した接続関連付けられている接続プールを空にします。
パブリック メソッド Close オーバーライドされます。 データベースへの接続を閉じます。このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。
パブリック メソッド CreateCommand SqlConnection関連付けられている SqlCommand オブジェクト作成し、返します。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成に必要な情報をすべて格納しているオブジェクト作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされます。 Component によって使用されているリソース解放します。 ( Component から継承されます。)
パブリック メソッド EnlistDistributedTransaction 指定した分散トランザクション参加します。
パブリック メソッド EnlistTransaction オーバーライドされます。 指定した分散トランザクション参加します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンス等しかどうか判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する、現在の有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetSchema オーバーロードされます。 オーバーライドされます。 この SqlConnectionデータ ソーススキーマ情報返します。
パブリック メソッド GetType  現在のインスタンスType取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する、有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Open オーバーライドされます。 ConnectionString で指定したプロパティ設定使用して、データベース接続開きます。
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 ( Object から継承されます。)
パブリック メソッド ResetStatistics 統計情報収集が有効にされている場合すべての値はゼロリセットされます。
パブリック メソッド RetrieveStatistics メソッド呼び出された時点統計情報の、名前/値ペアから成るコレクション返します。
パブリック メソッド ToString  Component の名前を格納している String返します (存在する場合)。このメソッドオーバーライドできません。 ( Component から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Dispose  オーバーロードされます。 Component によって使用されているリソース解放します。 ( Component から継承されます。)
プロテクト メソッド Finalize  Componentガベージ コレクションによってクリアされる前に、アンマネージ リソース解放し、その他のクリーンアップ操作実行します。 ( Component から継承されます。)
プロテクト メソッド GetService  Component またはその Container で提供されるサービスを表すオブジェクト返します。 ( Component から継承されます。)
プロテクト メソッド MemberwiseClone  オーバーロードされます。 ( MarshalByRefObject から継承されます。)
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDbConnection.BeginTransaction オーバーロードされます。  
インターフェイスの明示的な実装 System.ICloneable.Clone 現在のインスタンスコピーである新しオブジェクト作成します。
インターフェイスの明示的な実装 System.IDisposable.Dispose  
参照参照

SqlConnection メンバ

SQL Server データベースへの開いた接続を表します。このクラス継承できません。

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド SqlConnection オーバーロードされます。 SqlConnection クラス新しインスタンス初期化します。
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ参照)
  名前 説明
パブリック プロパティ ConnectionString オーバーライドされます。 SQL Server データベースを開くために使用する文字列取得または設定します。
パブリック プロパティ ConnectionTimeout オーバーライドされます。 接続確立試行開始してから、その試行終了してエラー生成するまでの待機時間取得します。
パブリック プロパティ Container  Component格納している IContainer取得します。(Component から継承されます。)
パブリック プロパティ Database オーバーライドされます。 現在のデータベース、または接続が開いてから使用するデータベースの名前を取得します。
パブリック プロパティ DataSource オーバーライドされます。 接続する SQL Serverインスタンスの名前を取得します。
パブリック プロパティ ServerVersion オーバーライドされます。 クライアント接続している SQL Serverインスタンスバージョンを示す文字列を取得します。
パブリック プロパティ Site  ComponentISite取得または設定します。(Component から継承されます。)
パブリック プロパティ State オーバーライドされます。 SqlConnection の状態を示します。
パブリック プロパティ WorkstationId データベース クライアント識別する文字列取得します。
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ CanRaiseEvents  コンポーネントイベント発生させることがきかどうかを示す値を取得します。(Component から継承されます。)
プロテクト プロパティ DesignMode  Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
プロテクト プロパティ Events  Component に結び付けられているイベント ハンドラリスト取得します。(Component から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド参照)
  名前 説明
パブリック メソッド BeginTransaction オーバーロードされます。 データベース トランザクション開始します。
パブリック メソッド ChangeDatabase オーバーライドされます。 開いている SqlConnection の現在のデータベース変更します。
パブリック メソッド ChangePassword 接続文字列中に指定されているユーザーSQL Server パスワードを、指定された新しパスワード変更します。
パブリック メソッド ClearAllPools 接続プールを空にします。
パブリック メソッド ClearPool 指定した接続関連付けられている接続プールを空にします。
パブリック メソッド Close オーバーライドされます。 データベースへの接続を閉じます。このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。
パブリック メソッド CreateCommand SqlConnection関連付けられている SqlCommand オブジェクト作成し、返します。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成に必要な情報をすべて格納しているオブジェクト作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされます。 Component によって使用されているリソース解放します。 (Component から継承されます。)
パブリック メソッド EnlistDistributedTransaction 指定した分散トランザクション参加します。
パブリック メソッド EnlistTransaction オーバーライドされます。 指定した分散トランザクション参加します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンス等しかどうか判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する、現在の有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetSchema オーバーロードされます。 オーバーライドされます。 この SqlConnectionデータ ソーススキーマ情報返します。
パブリック メソッド GetType  現在のインスタンスType取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する、有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Open オーバーライドされます。 ConnectionString で指定したプロパティ設定使用して、データベース接続開きます。
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 (Object から継承されます。)
パブリック メソッド ResetStatistics 統計情報収集が有効にされている場合すべての値はゼロリセットされます。
パブリック メソッド RetrieveStatistics メソッド呼び出された時点統計情報の、名前/値ペアから成るコレクション返します。
パブリック メソッド ToString  Component の名前を格納している String返します (存在する場合)。このメソッドオーバーライドできません。 (Component から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Dispose  オーバーロードされます。 Component によって使用されているリソース解放します。 (Component から継承されます。)
プロテクト メソッド Finalize  Componentガベージ コレクションによってクリアされる前に、アンマネージ リソース解放し、その他のクリーンアップ操作実行します。 (Component から継承されます。)
プロテクト メソッド GetService  Component またはその Container で提供されるサービスを表すオブジェクト返します。 (Component から継承されます。)
プロテクト メソッド MemberwiseClone  オーバーロードされます。 ( MarshalByRefObject から継承されます。)
パブリック イベントパブリック イベント
  名前 説明
パブリック イベント Disposed  コンポーネントの Disposed イベント待機するイベント ハンドラ追加します。(Component から継承されます。)
パブリック イベント InfoMessage SQL Server警告メッセージまたは情報メッセージ返したときに発生します。
パブリック イベント StateChange  イベントの状態が変更したときに発生します。(DbConnection から継承されます。)
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDbConnection.BeginTransaction オーバーロードされます。  
インターフェイスの明示的な実装 System.ICloneable.Clone 現在のインスタンスコピーである新しオブジェクト作成します。
インターフェイスの明示的な実装 System.IDisposable.Dispose  
参照参照




SqlConnectionに関係した商品


SqlConnectionのページへのリンク
「SqlConnection」の関連用語
SqlConnectionのお隣キーワード
モバイル
モバイル版のWeblioは、下記のURLからアクセスしてください。
http://m.weblio.jp/
_ _   


SqlConnectionのページの著作権
Weblio 辞書情報提供元は参加元一覧にて確認できます。

  
マイクロソフトマイクロソフト
© 2011 Microsoft Corporation.All rights reserved.

©2011 Weblio RSS