SqlConnection イベント

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

関連項目
SqlConnection クラスSystem.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得.NET Framework Data Provider for SQL Server の使用
SqlConnection クラス
アセンブリ: System.Data (system.data.dll 内)


SqlConnection オブジェクトは、SQL Server データ ソースへの一意なセッションを表します。クライアント/サーバー データベース システムでは、サーバーへのネットワーク接続に相当します。SqlConnection は、Microsoft SQL Server データベースへの接続のパフォーマンスを向上させるために、SqlDataAdapter および SqlCommand と組み合わせて使用します。すべてのサードパーティ SQL サーバー製品、および OLE DB をサポートするその他のデータ ソースでは、OleDbConnection を使用してください。
SqlConnection のインスタンスを作成すると、すべてのプロパティが初期値に設定されます。これらの初期値の一覧については、SqlConnection コンストラクタのトピックを参照してください。
SqlConnection は、適用範囲の外では開いたままになります。そのため、Close または Dispose を呼び出して、明示的に接続を閉じる必要があります。Close と Dispose の機能は同じです。接続プール値 Pooling が true または yes に設定されている場合、基になる接続は接続プールに返されます。一方、Pooling が false または 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」を参照してください。
![]() |
---|
Microsoft .NET Framework Version 1.0 をご使用の場合、Open を使用して SQL Server に接続するためには、名前付きのアクセス許可セット FullTrust が必要です。.NET Framework Version 1.1 以降をご使用の場合、その必要はありません。詳細については、アクセス許可の要求、名前付きアクセス許可セット の各トピックを参照してください。 |
サーバーから受け取る警告メッセージと情報メッセージの処理の詳細については、「接続イベントの使用」を参照してください。

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.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbConnection
System.Data.SqlClient.SqlConnection


Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlConnection コンストラクタ ()
アセンブリ: System.Data (system.data.dll 内)


SqlConnection の新しいインスタンスを作成すると、読み書き可能プロパティは、ConnectionString プロパティのキーワードを関連付けて設定した場合を除いて、次の初期値に設定されます。
これらのプロパティの値を変更するには、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;"; }

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlConnection コンストラクタ (String)
アセンブリ: System.Data (system.data.dll 内)

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

SqlConnection の新しいインスタンスを作成すると、読み書き可能プロパティは、ConnectionString プロパティのキーワードを関連付けて設定した場合を除いて、次の初期値に設定されます。
これらのプロパティの値を変更するには、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;"; }

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


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 | Component の ISite を取得または設定します。 ( Component から継承されます。) |
![]() | State | オーバーライドされます。 SqlConnection の状態を示します。 |
![]() | WorkstationId | データベース クライアントを識別する文字列を取得します。 |

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

関連項目
SqlConnection クラスSystem.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得.NET Framework Data Provider for SQL Server の使用
SqlConnection メソッド


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

名前 | 説明 | |
---|---|---|
![]() | System.Data.IDbConnection.BeginTransaction | オーバーロードされます。 |
![]() | System.ICloneable.Clone | 現在のインスタンスのコピーである新しいオブジェクトを作成します。 |
![]() | System.IDisposable.Dispose |

関連項目
SqlConnection クラスSystem.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得.NET Framework Data Provider for SQL Server の使用
SqlConnection メンバ
SQL Server データベースへの開いた接続を表します。このクラスは継承できません。
SqlConnection データ型で公開されるメンバを以下の表に示します。


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

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。(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 クラスSystem.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得.NET Framework Data Provider for SQL Server の使用
Weblioに収録されているすべての辞書からSQL connectionを検索する場合は、下記のリンクをクリックしてください。

- SQL connectionのページへのリンク