SqlConnection 概述

• 公共构造函数

SqlConnection 构造函数

已重载。初始化 SqlConnection 类的新实例。

• 公共属性

ConnectionString	获取或设置用于打开 SQL Server 数据库的字符串。
ConnectionTimeout	获取在尝试建立连接时终止尝试并生成错误之前所等待的时间。
Container（从 Component 继承）	获取 IContainer，它包含 Component。
Database	获取当前数据库或在连接打开后要使用的数据库的名称。
DataSource	获取要连接的 SQL Server 实例的名称。
PacketSize	获取用来与 SQL Server 的实例通讯的网络数据包的大小（以字节为单位）。
ServerVersion	获取包含客户端要连接的 SQL Server 实例的版本的字符串。
Site（从 Component 继承）	获取或设置 Component 的 ISite。
State	获取连接的当前状态。
WorkstationId	获取标识数据库客户端的一个字符串。

公共方法

BeginTransaction	已重载。开始数据库事务。
ChangeDatabase	为打开的 SqlConnection 更改当前数据库。
Close	关闭与数据库的连接。这是关闭任何打开连接的首选方法。Close 方法回滚任何挂起的事务。然后，它将连接释放到连接池，或者在连接池被禁用的情况下关闭连接。应用程序可以多次调用 Close。不会生成任何异常。
CreateCommand	创建并返回一个与 SqlConnection 关联的 SqlCommand 对象。
CreateObjRef（从MarshalByRefObject继承）	创建一个对象，该对象包含生成用于与远程对象进行通讯的代理所需的全部相关信息。
Dispose（从 Component 继承）	已重载。释放由 Component 占用的资源。
Equals（从 Object 继承）	已重载。确定两个 Object 实例是否相等。
GetHashCode（从 Object 继承）	用作特定类型的哈希函数，适合在哈希算法和数据结构（如哈希表）中使用。
GetLifetimeService（从 MarshalByRefObject 继承）	检索控制此实例的生存期策略的当前生存期服务对象。返回值ILease 类型的对象，用于控制此实例的生存期策略。
GetType（从 Object 继承）	获取当前实例的 Type。
InitializeLifetimeService（从 MarshalByRefObject 继承）	获取控制此实例的生存期策略的生存期服务对象。
Open	使用 ConnectionString 所指定的属性设置打开数据库连接。
ToString（从 Object 继承）	返回表示当前 Object 的 String。

公共事件

Disposed（从 Component 继承）	添加事件处理程序以侦听组件上的 Disposed 事件。
InfoMessage	当 SQL Server 返回一个警告或信息性消息时发生。
StateChange	当连接状态更改时发生。

受保护的属性

DesignMode（从 Component 继承）	获取一个值，用以指示 Component 当前是否处于设计模式。
Events（从 Component 继承）	获取附加到此 Component 的事件处理程序的列表。

受保护的方法

Dispose	已重载。已重写。释放由 SqlConnection 占用的资源。
Finalize（从 Object 继承）	已重写。允许 Object 在“垃圾回收”回收 Object 之前尝试释放资源并执行其他清理操作。 在 C# 和 C++ 中，使用析构函数语法来表示终结程序。
GetService（从 Component 继承）	返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。
MemberwiseClone（从 Object 继承）	创建当前 Object 的浅表副本。

初始化 SqlConnection 类的新实例。

重载列表

初始化 SqlConnection 类的新实例。

[Visual Basic] Public Sub New()

[C#] public SqlConnection();

[C++] public: SqlConnection();

[JScript] public function SqlConnection();

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

[Visual Basic] Public Sub New(String)

[C#] public SqlConnection(string);

[C++] public: SqlConnection(String*);

[JScript] public function SqlConnection(String);

示例

[Visual Basic, C#] 下面的示例创建并打开一个 SqlConnection。

[Visual Basic, C#] 注意   此示例显示如何使用 SqlConnection 构造函数的一个重载版本。有关其他可用示例，请参阅单独的重载主题。

[Visual Basic]
Public Sub CreateSqlConnection()
    Dim myConnectString As String = "user id=sa;password=Jx$442pt;initial 
catalog=northwind;data source=mySQLServer;Connect Timeout=30"
    Dim myConnection As New SqlConnection(myConnectString)
    myConnection.Open()
End Sub 'CreateSqlConnection

[C#]
public void CreateSqlConnection() 
 {
    string myConnectString = "user id=sa;password=Jx$442pt;initial 
catalog=northwind;data source=mySQLServer;Connect Timeout=30";
    SqlConnection myConnection = new SqlConnection(myConnectString);
    myConnection.Open();
 }