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