语言

SqlConnection 构造函数

定义

初始化 SqlConnection 类的新实例。

对于新开发,请使用Microsoft。Data.SqlClient。 此页面记录 System.Data.SqlClient。

重载

名称 说明
SqlConnection()

初始化 SqlConnection 类的新实例。

对于新开发,请使用Microsoft。Data.SqlClient。 此页面记录 System.Data.SqlClient。

SqlConnection(String)

给定包含连接字符串的 SqlConnection 字符串时,初始化类的新实例。

对于新开发,请使用Microsoft。Data.SqlClient。 此页面记录 System.Data.SqlClient。

SqlConnection(String, SqlCredential)

在给定连接字符串的情况下初始化类的新实例,该字符串 SqlConnection 不使用 Integrated Security = true 该字符串,以及 SqlCredential 包含用户 ID 和密码的对象。

对于新开发,请使用Microsoft。Data.SqlClient。 此页面记录 System.Data.SqlClient。

SqlConnection()

Source:
System.Data.SqlClient.notsupported.cs

初始化 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)

Source:
System.Data.SqlClient.notsupported.cs

给定包含连接字符串的 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.SqlConnection
Public 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)

Source:
System.Data.SqlClient.notsupported.cs

在给定连接字符串的情况下初始化类的新实例,该字符串 SqlConnection 不使用 Integrated Security = true 该字符串,以及 SqlCredential 包含用户 ID 和密码的对象。

对于新开发,请使用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.SqlConnection
Public Sub New (connectionString As String, credential As SqlCredential)

参数

connectionString
String

不使用下列任何连接字符串关键字的连接字符串:Integrated Security = true、或UserIdPassword不使用ContextConnection = true的连接字符串。

credential
SqlCredential

SqlCredential 对象。 如果 credential 为 null, SqlConnection(String, SqlCredential) 则功能上等效于 SqlConnection(String).

例外

提供的连接字符串参数验证失败 ConnectionString 。

另请参阅

适用于