SqlConnection コンストラクター

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

オーバーロード

SqlConnection()	SqlConnection クラスの新しいインスタンスを初期化します。
SqlConnection(String)	接続文字列を示す文字列を指定して、SqlConnection クラスの新しいインスタンスを初期化します。
SqlConnection(String, SqlCredential)	Integrated Security = true と、ユーザー ID とパスワードを含む SqlCredential オブジェクトを使用しない接続文字列を指定して、SqlConnection クラスの新しいインスタンスを初期化します。

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 データベースを開くために使用される接続。

例外

ArgumentException

指定された接続文字列引数の検証に失敗しました 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) と機能的に同等です。

例外

ArgumentException

指定された引数は、検証を含む ConnectionString 検証に失敗しました。