SqlConnection 构造函数

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

重载

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

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 关联关键字专门设置它们。

属性	初始值
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 关联关键字专门设置它们。

属性	初始值
ConnectionString	connectionString
ConnectionTimeout	15
Database	空字符串 (“”)
DataSource	空字符串 (“”)

只能使用 ConnectionString 属性更改这些属性的值。 类 SqlConnection 提供用于创建和管理连接字符串内容的功能。

SqlConnection(String, SqlCredential)

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

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

不使用 ContextConnection = true 或以下任何连接字符串关键字的连接字符串：Integrated Security = true、UserId 或 Password。

credential

SqlCredential

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

例外

ArgumentException

提供的参数未通过验证，包括 ConnectionString 验证。