SqlConnection コンストラクター

定義

名前空間:: System.Data.SqlClient

アセンブリ:: System.Data.SqlClient.dll

アセンブリ:: System.Data.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

SqlConnection クラスの新しいインスタンスを初期化します。

オーバーロード

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

SqlConnection()

ソース:: System.Data.SqlClient.notsupported.cs

SqlConnection クラスの新しいインスタンスを初期化します。

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)

ソース:: System.Data.SqlClient.notsupported.cs

接続文字列を含む文字列が指定されたときに、 SqlConnection クラスの新しいインスタンスを初期化します。

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

SQL Server データベースを開くために使用される接続。

例外

ArgumentException

指定された接続文字列引数が検証 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

注釈

プロパティ	初期値
ConnectionString	`connectionString`
ConnectionTimeout	15
Database	空の文字列 ("")
DataSource	空の文字列 ("")

これらのプロパティの値は、 ConnectionString プロパティを使用してのみ変更できます。 SqlConnection クラスは、接続文字列の内容を作成および管理するための機能を提供します。

こちらもご覧ください

適用対象

SqlConnection(String, SqlCredential)

ソース:: System.Data.SqlClient.notsupported.cs

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

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.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 失敗しました。

こちらもご覧ください

ADO.NET の概要

適用対象

フィードバック

このページはお役に立ちましたか?

次の方法で共有

SqlConnection コンストラクター

定義

オーバーロード

SqlConnection()

例

注釈

こちらもご覧ください

適用対象

SqlConnection(String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

SqlConnection(String, SqlCredential)

パラメーター

例外

こちらもご覧ください

適用対象

フィードバック