SqlConnection 构造函数

定义

命名空间:: System.Data.SqlClient

程序集:: System.Data.SqlClient.dll

程序集:: System.Data.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 SqlConnection 类的新实例。

重载

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

SqlConnection()

Source:: 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)

Source:: 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

注解

创建新实例 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 和密码的对象。

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).

例外

ArgumentException

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

另请参阅

ADO.NET 概述

适用于

反馈

此页面是否有帮助？

通过

SqlConnection 构造函数

定义

重载

SqlConnection()

示例

注解

另请参阅

适用于

SqlConnection(String)

参数

例外

示例

注解

另请参阅

适用于

SqlConnection(String, SqlCredential)

参数

例外

另请参阅

适用于

反馈