SQLServer---SqlConnection类.doc

SqlConnection 类表示 SQL Server 数据库的一个打开的连接。 此类不能被继承。 继承层次结构 System.Object System.MarshalByRefObjectSystem.ComponentModel.ComponentSystem.Data.Common.DbConnectionSystem.Data.SqlClient.SqlConnection命名空间： System.Data.SqlClient程序集： System.Data（在 System.Data.dll 中） 语法 public sealed class SqlConnection : DbConnection, ICloneableSqlConnection 类型公开以下成员。构造函数 名称说明SqlConnection 初始化 SqlConnection 类的新实例。 SqlConnection(String) 如果给定包含连接字符串的字符串，则初始化 SqlConnection 类的新实例。 属性 名称说明CanRaiseEvents 获取一个指示组件是否可以引发事件的值。 （继承自 Component。）ConnectionString 获取或设置用于打开 SQL Server 数据库的字符串。 （重写 DbConnection.ConnectionString。）ConnectionTimeout 获取在尝试建立连接时终止尝试并生成错误之前所等待的时间。 （重写 DbConnection.ConnectionTimeout。）Container 获取 IContainer，它包含 Component。 （继承自 Component。）Database 获取当前数据库或连接打开后要使用的数据库的名称。 （重写 DbConnection.Database。）DataSource 获取要连接的 SQL Server 实例的名称。 （重写 DbConnection.DataSource。）DbProviderFactory 获取此 DbConnection 的 DbProviderFactory。 （继承自 DbConnection。）DesignMode 获取一个值，用以指示 Component 当前是否处于设计模式。 （继承自 Component。）Events 获取附加到此 Component 的事件处理程序的列表。 （继承自 Component。）FireInfoMessageEventOnUserErrors 获取或设置 FireInfoMessageEventOnUserErrors 属性。 PacketSize 获取用来与 SQL Server 的实例通信的网络数据包的大小（以字节为单位）。 ServerVersion 获取包含客户端连接的 SQL Server 实例的版本的字符串。 （重写 DbConnection.ServerVersion。）Site 获取或设置 Component 的 ISite。 （继承自 Component。）State 指示 SqlConnection 的状态。 （重写 DbConnection.State。）StatisticsEnabled 如果设置为 true，则对当前连接启用统计信息收集。 WorkstationId 获取标识数据库客户端的一个字符串。 方法 名称说明BeginDbTransaction 开始数据库事务。 （继承自 DbConnection。）BeginTransaction 开始数据库事务。 BeginTransaction(IsolationLevel) 以指定的隔离级别启动数据库事务。 BeginTransaction(String) 以指定的事务名称启动数据库事务。 BeginTransaction(IsolationLevel, String) 以指定的隔离级别和事务名称启动数据库事务。 ChangeDatabase 为打开的 SqlConnection 更改当前数据库。 （重写 DbConnection.ChangeDatabase(String)。）ChangePassword 将连接字符串中指示的用户的 SQL Server 密码更改为提供的新密码。 ClearAllPools 清空连接池。 ClearPool 清空与指定连接关联的连接池。 Close 关闭与数据库的连接。 此方法是关闭任何已打开连接的首选方法。 （重写 DbConnection.Close。）CreateCommand 创建并返回一个与 SqlConnection 关联的 SqlCommand 对象。 CreateDbCommand 创建并返回与当前连接关联的 DbCommand 对象。 （继承自 DbConnection。）CreateObjRef 创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 （继承自 MarshalByRefObject。）Dispose 释放由 Component 使用的所有资源。 （继承自 Component。）Dispose(Boolean) 释放 Component 占用的非托管资源，也可以选择释放托管资源。 （继承自 Component。）EnlistDistributedTransaction 在指定的事务中登记为分布式事务。 EnlistTransaction 在指定的事务中登记为分布式事务。 （重写 DbConnection.EnlistTransaction(Transaction)。）Equals(Object) 确定指定的 Object 是否等于当前的 Object。 （继承自 Object。）Finalize 在通过垃圾回收将 Component 回收之前，释放非托管资源并执行其他清理操作。 （继承自 Component。）GetHashCode 用作特定类型的哈希函数。 （继承自 Object。）GetLifetimeService 检索控制此实例的生存期策略的当前生存期服务对象。 （继承自 MarshalByRefObject。）GetSchema 返回此 SqlConnection 的数据源的架构信息。 （重写 DbConnection.GetSchema。）GetSchema(String) 使用指定的架构名称字符串，返回此 SqlConnection 的数据源的架构信息。 （重写 DbConnection.GetSchema(String)。）GetSchema(String, String() 使用指定的架构名称字符串和指定的限制值字符串数组，返回此 SqlConnection 的数据源的架构信息。 （重写 DbConnection.GetSchema(String, String()。）GetService 返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 （继承自 Component。）GetType 获取当前实例的 Type。 （继承自 Object。）InitializeLifetimeService 获取控制此实例的生存期策略的生存期服务对象。 （继承自 MarshalByRefObject。）MemberwiseClone 创建当前 Object 的浅表副本。 （继承自 Object。）MemberwiseClone(Boolean) 创建当前 MarshalByRefObject 对象的浅表副本。 （继承自 MarshalByRefObject。）OnStateChange 引发 StateChange 事件。 （继承自 DbConnection。）Open 使用 ConnectionString 所指定的属性设置打开数据库连接。 （重写 DbConnection.Open。）ResetStatistics 如果启用统计信息收集，则所有的值都将重置为零。 RetrieveStatistics 调用该方法时，将返回统计信息的名称值对集合。 ToString 返回包含 Component 的名称的 String（如果有）。 不应重写此方法。 （继承自 Component。）事件 名称说明Disposed 当通过调用 Dispose 方法释放组件时发生。 （继承自 Component。）InfoMessage 当 SQL Server 返回一个警告或信息性消息时发生。 StateChange 当事件状态更改时发生。 （继承自 DbConnection。）显式接口实现 名称说明ICloneable.Clone 创建作为当前实例副本的新对象。 IDbConnection.BeginTransaction 开始数据库事务。 （继承自 DbConnection。）IDbConnection.BeginTransaction(IsolationLevel) 以指定的 IsolationLevel 值开始一个数据库事务。 （继承自 DbConnection。）IDbConnection.CreateCommand 创建并返回与当前连接关联的 DbCommand 对象。 （继承自 DbConnection。）备注 SqlConnection 对象表示与 SQL Server 数据源的一个唯一的会话。 在客户端/服务器数据库系统中，它等效于一个到服务器的网络连接。 SqlConnection 与 SqlDataAdapter 和 SqlCommand 一起使用，以便在连接到 Microsoft SQL Server 数据库时提高性能。 对于所有第三方 SQL 服务器产品以及其他支持 OLE DB 的数据源，请使用 OleDbConnection。 当创建 SqlConnection 的实例时，所有属性都设置为它们的初始值。 有关这些值的列表，请参见 SqlConnection 构造函数。 有关连接字符串中的关键字列表，请参见 ConnectionString。 如果 SqlConnection 超出范围，则不会将其关闭。 因此，必须通过调用Close或Dispose显式关闭该连接。 Close 和 Dispose 的功能等效。 如果连接池值 Pooling 设置为 true 或 yes，则基础连接将返回到连接池。 另一方面，如果 Pooling 设置为 false 或 no，则实际上会关闭到服务器的基础连接。 注意 在从连接池中获取连接或将连接返回到连接池时，将不会在服务器上引发登录和注销事件，因为在将连接返回到连接池时，将不会实际关闭连接。 有关更多信息，请参见 SQL Server 连接池 (ADO.NET)。 若要确保连接始终关闭，请在 using 块内部打开连接，如下面的代码段所示。 这样可确保在代码退出代码块时自动关闭连接。 C#VB复制 using (SqlConnection connection = new SqlConnection(connectionString) connection.Open(); / Do work here; connection closed on following line. 注意若要部署高性能应用程序，则必须使用连接池。 在使用用于 SQL Server 的 .NET Framework 数据提供程序时，不必启用连接池，因为提供程序会自动对此进行管理，不过您可以修改某些设置。 有关更多信息，请参见 SQL Server 连接池 (ADO.NET)。 如果执行 SqlCommand 的方法生成 SqlException，那么当严重级别小于等于 19 时，SqlConnection 将仍保持打开状态。 当严重级别大于等于 20 时，服务器通常会关闭 SqlConnection。 但是，用户可以重新打开连接并继续操作。 创建 SqlConnection 对象的实例的应用程序可通过设置声明性或命令性安全要求，要求所有直接和间接的调用方都具有访问代码的充分权限。 SqlConnection 使用 SqlClientPermission 对象设置安全要求。 用户可以通过使用 SqlClientPermissionAttribute 对象来验证他们的代码是否具有足够的权限。 用户和管理员还可以使用Caspol.exe（代码访问安全策略工具） 来修改计算机、用户和企业级别的安全策略。 有关更多信息，请参见 .NET Framework 中的安全性。 有关演示如何使用安全请求的示例，请参见 代码访问安全性和 ADO.NET。 注意如果您正在使用 Microsoft .NET Framework 1.0 版，则在使用 Open 连接到 SQL Server 时必须使用 FullTrust 命名权限集。 如果使用的是 .NET Framework 1.1 版或更高版本，则此要求不适用。 有关更多信息，请参见请求权限和命名的权限集。 有关处理来自服务器的警告和信息性消息的更多信息，请参见连接事件 (ADO.NET)。 SQL Server Books Online（SQL Server 联机丛书）中记载了 SQL Server 引擎错误和错误消息。 警告ADO.NET 2.0 不支持在 SQL Server 2000 或更低版本的共享内存上执行异步命令。 但是，可以强制用 TCP 代替共享内存。 可通过在连接字符串中的服务器名称之前添加tcp:前缀或使用本地主机来达到此目的。 TopicLocation如何：创建与 SQL Server 数据库的连接Visual Studio 中的数据访问如何：创建与 SQL Server 数据库的连接Visual Studio 中的数据访问示例 下面的示例创建一个 SqlCommand 和一个 SqlConnection。 SqlConnection 打开，并设置为 SqlCommand 的 Connection。 该示例然后调用 ExecuteNonQuery。 为了完成此任务，将为 ExecuteNonQuery 传递一个连接字符串和一个查询字符串，后者是一个 Transact-SQL INSERT 语句。 当代码使用块退出时，连接自动关闭。 C#VB复制 private static void CreateCommand(string queryString, string connectionString) using (S