SqlConnection 类

定义

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable

public ref class SqlConnection sealed : System::Data::Common::DbConnection

public ref class SqlConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection

public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable

public sealed class SqlConnection : System.Data.Common.DbConnection

public sealed class SqlConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection

type SqlConnection = class
    inherit DbConnection
    interface ICloneable

type SqlConnection = class
    inherit DbConnection

type SqlConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface ICloneable

Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable

Public NotInheritable Class SqlConnection
Inherits DbConnection

Public NotInheritable Class SqlConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable

继承

Object

DbConnection

SqlConnection

继承

Object

MarshalByRefObject

Component

DbConnection

SqlConnection

继承

Object

MarshalByRefObject

Component

SqlConnection

实现

ICloneable IDbConnection IDisposable

示例

以下示例创建 SqlCommand 和 SqlConnection。 SqlConnection打开 并设置为 Connection 的 SqlCommand。 然后，该示例调用 ExecuteNonQuery。 为此，向 ExecuteNonQuery 传递连接字符串和作为 Transact-SQL INSERT 语句的查询字符串。 当代码退出 using 块时，连接会自动关闭。

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

注解

对象SqlConnection表示与SQL Server数据源的唯一会话。 对于客户端/服务器数据库系统，它等效于与服务器的网络连接。 SqlConnection与 SqlDataAdapter 和 SqlCommand 一起使用，以在连接到 Microsoft SQL Server 数据库时提高性能。 对于所有第三方SQL Server产品和其他 OLE DB 支持的数据源，请使用 OleDbConnection。

创建 实例 SqlConnection时，所有属性都设置为其初始值。 有关这些值的列表，请参阅 SqlConnection 构造函数。

有关连接字符串中关键字的列表，请参阅 ConnectionString 。

SqlConnection如果 超出范围，则不会关闭。 因此，必须通过调用 Close 或 Dispose显式关闭连接。 Close 和 Dispose 在功能上是等效的。 如果连接池值 Pooling 设置为 true 或 yes，则基础连接将返回到连接池。 另一方面，如果 Pooling 设置为 false 或 no，则实际上会关闭与服务器的基础连接。

若要确保始终关闭连接，请打开 块内的 using 连接，如以下代码片段所示。 这样做可确保在代码退出块时自动关闭连接。

Using connection As New SqlConnection(connectionString)
    connection.Open()
    ' Do work here; connection closed on following line.
End Using

using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        // Do work here; connection closed on following line.
    }

SqlException如果 由执行 的方法生成 ，SqlCommand则 当严重性级别为 19 或更低时， SqlConnection 将保持打开状态。 当严重性级别为 20 或更高时，服务器通常会关闭 SqlConnection。 但是，用户可以重新打开连接并继续操作。

创建对象实例 SqlConnection 的应用程序可以要求所有直接和间接调用方通过设置声明性或命令性安全要求来对代码具有足够的权限。 SqlConnection 使用 SqlClientPermission 对象提出安全要求。 用户可以使用 对象验证其代码是否具有足够的权限 SqlClientPermissionAttribute 。 用户和管理员还可以使用 Caspol.exe (代码访问安全策略工具) 在计算机、用户和企业级别修改安全策略。 有关详细信息，请参阅 .NET 中的安全性。 有关演示如何使用安全要求的示例，请参阅 代码访问安全性和 ADO.NET。

有关处理来自服务器的警告和信息性消息的详细信息，请参阅 连接事件。 有关SQL Server引擎错误和错误消息的详细信息，请参阅数据库引擎事件和错误。

构造函数

属性

方法

事件

显式接口实现

适用于

另请参阅

• 在 ADO.NET 中连接到数据源
• SQL Server 和 ADO.NET
• ADO.NET 概述