SqlConnection コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SqlConnection クラスの新しいインスタンスを初期化します。
新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。
オーバーロード
| Name | 説明 |
|---|---|
| SqlConnection() |
SqlConnection クラスの新しいインスタンスを初期化します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| SqlConnection(String) |
接続文字列を含む文字列が指定されたときに、 SqlConnection クラスの新しいインスタンスを初期化します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| SqlConnection(String, SqlCredential) |
SqlConnectionとユーザー ID とパスワードを含む 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
SqlConnection()
SqlConnection クラスの新しいインスタンスを初期化します。
新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。
public:
SqlConnection();public SqlConnection();Public Sub New ()例
次の例では、 SqlConnectionを作成して開きます。
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.ConfigurationManager.ConnectionStrings property
return "Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI;";
}
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.ConfigurationManager.ConnectionStrings property
Return "Data Source=(local);Database=AdventureWorks;" _
& "Integrated Security=SSPI;"
End Function
注釈
SqlConnectionの新しいインスタンスが作成されると、読み取り/書き込みプロパティは、ConnectionString プロパティで関連するキーワードを使用して明示的に設定されていない限り、次の初期値に設定されます。
| プロパティ | 初期値 |
|---|---|
| ConnectionString | 空の文字列 ("") |
| ConnectionTimeout | 15 |
| Database | 空の文字列 ("") |
| DataSource | 空の文字列 ("") |
これらのプロパティの値は、 ConnectionString プロパティを使用してのみ変更できます。 SqlConnectionStringBuilder クラスは、接続文字列の内容を作成および管理するための機能を提供します。
関連項目
適用対象
SqlConnection(String)
接続文字列を含む文字列が指定されたときに、 SqlConnection クラスの新しいインスタンスを初期化します。
新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。
public:
SqlConnection(System::String ^ connectionString);public SqlConnection(string connectionString);new System.Data.SqlClient.SqlConnection : string -> System.Data.SqlClient.SqlConnectionPublic Sub New (connectionString As String)パラメーター
- connectionString
- String
SQL Server データベースを開くために使用される接続。
例外
指定された接続文字列引数が検証 ConnectionString 失敗しました。
例
次の例では、 SqlConnectionを作成して開きます。
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;";
}
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
注釈
SqlConnectionの新しいインスタンスが作成されると、読み取り/書き込みプロパティは、ConnectionString プロパティで関連するキーワードを使用して明示的に設定されていない限り、次の初期値に設定されます。
| プロパティ | 初期値 |
|---|---|
| ConnectionString | connectionString |
| ConnectionTimeout | 15 |
| Database | 空の文字列 ("") |
| DataSource | 空の文字列 ("") |
これらのプロパティの値は、 ConnectionString プロパティを使用してのみ変更できます。 SqlConnection クラスは、接続文字列の内容を作成および管理するための機能を提供します。
関連項目
適用対象
SqlConnection(String, SqlCredential)
SqlConnectionとユーザー ID とパスワードを含むIntegrated Security = true オブジェクトを使用しない接続文字列を指定して、SqlCredential クラスの新しいインスタンスを初期化します。
新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。
public:
SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential);public SqlConnection(string connectionString, System.Data.SqlClient.SqlCredential credential);new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnectionPublic Sub New (connectionString As String, credential As SqlCredential)パラメーター
- connectionString
- String
Integrated Security = true、UserId、またはPasswordのいずれかの接続文字列キーワードを使用しない接続文字列、またはContextConnection = trueを使用しない接続文字列。
- credential
- SqlCredential
SqlCredential オブジェクト。
credentialが null の場合、SqlConnection(String, SqlCredential)は機能的にはSqlConnection(String)と同等です。
例外
指定された接続文字列引数が検証 ConnectionString 失敗しました。
