SqlConnection SqlConnection SqlConnection SqlConnection Constructors

定義

オーバーロード

SqlConnection() SqlConnection() SqlConnection()

SqlConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlConnection class.

SqlConnection(String) SqlConnection(String) SqlConnection(String) SqlConnection(String)

接続文字列を示す文字列を指定して、SqlConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlConnection class when given a string that contains the connection string.

SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential)

Integrated Security = true と、ユーザー ID とパスワードを含む SqlCredential オブジェクトを使用しない接続文字列を指定して、SqlConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlConnection class given a connection string, that does not use Integrated Security = true and a SqlCredential object that contains the user ID and password.

SqlConnection() SqlConnection() SqlConnection()

SqlConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlConnection class.

public:
 SqlConnection();
public SqlConnection ();
Public Sub New ()

次の例では、をSqlConnection作成して開きます。The following example creates and opens a 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プロパティに関連付けられているキーワードを使用して明示的に設定されていない限り、読み取り/書き込みプロパティは次の初期値に設定されます。When a new instance of SqlConnection is created, the read/write properties are set to the following initial values unless they are specifically set using their associated keywords in the ConnectionString property.

プロパティProperties 初期値Initial value
ConnectionString 空の文字列 ("")empty string ("")
ConnectionTimeout 1515
Database 空の文字列 ("")empty string ("")
DataSource 空の文字列 ("")empty string ("")

これらのプロパティの値を変更するには、 ConnectionStringプロパティを使用する必要があります。You can change the value for these properties only by using the ConnectionString property. クラスSqlConnectionStringBuilderは、接続文字列の内容を作成および管理するための機能を提供します。The SqlConnectionStringBuilder class provides functionality for creating and managing the contents of connection strings.

こちらもご覧ください

SqlConnection(String) SqlConnection(String) SqlConnection(String) SqlConnection(String)

接続文字列を示す文字列を指定して、SqlConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlConnection class when given a string that contains the connection string.

public:
 SqlConnection(System::String ^ connectionString);
public SqlConnection (string connectionString);
new System.Data.SqlClient.SqlConnection : string -> System.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String)

パラメーター

connectionString
String String String String

SQL Server データベースを開くために使用される接続。The connection used to open the SQL Server database.

次の例では、をSqlConnection作成して開きます。The following example creates and opens a 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プロパティに関連付けられているキーワードを使用して明示的に設定されていない限り、読み取り/書き込みプロパティは次の初期値に設定されます。When a new instance of SqlConnection is created, the read/write properties are set to the following initial values unless they are specifically set using their associated keywords in the ConnectionString property.

プロパティProperties 初期値Initial value
ConnectionString connectionString
ConnectionTimeout 1515
Database 空の文字列 ("")empty string ("")
DataSource 空の文字列 ("")empty string ("")

これらのプロパティの値を変更するには、 ConnectionStringプロパティを使用する必要があります。You can change the value for these properties only by using the ConnectionString property. クラスSqlConnectionは、接続文字列の内容を作成および管理するための機能を提供します。The SqlConnection class provides functionality for creating and managing the contents of connection strings.

こちらもご覧ください

SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential)

Integrated Security = true と、ユーザー ID とパスワードを含む SqlCredential オブジェクトを使用しない接続文字列を指定して、SqlConnection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlConnection class given a connection string, that does not use Integrated Security = true and a SqlCredential object that contains the user ID and password.

public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ cred);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential cred);
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String, cred As SqlCredential)

パラメーター

connectionString
String String String String

接続文字列キーワード Integrated Security = trueUserIdPassword を使用しない接続文字列。または、ContextConnection = true を使用しない接続文字列。A connection string that does not use any of the following connection string keywords: Integrated Security = true, UserId, or Password; or that does not use ContextConnection = true.

credential
SqlCredential SqlCredential SqlCredential SqlCredential

SqlCredential オブジェクト。A SqlCredential object. credential が null である場合、SqlConnection(String, SqlCredential)SqlConnection(String) と機能的に同等です。If credential is null, SqlConnection(String, SqlCredential) is functionally equivalent to SqlConnection(String).

こちらもご覧ください

適用対象