Share via


IDbConnection 接口

表示到数据源的已打开连接,并且是由访问关系数据库的 .NET Framework 数据提供程序实现的。

**命名空间:**System.Data
**程序集:**System.Data(在 system.data.dll 中)

语法

声明
Public Interface IDbConnection
    Inherits IDisposable
用法
Dim instance As IDbConnection
public interface IDbConnection : IDisposable
public interface class IDbConnection : IDisposable
public interface IDbConnection extends IDisposable
public interface IDbConnection extends IDisposable

备注

IDbConnection 接口允许继承类实现 Connection 类,该类表示与数据源之间的唯一会话(例如,到服务器的一个网络连接)。有关 Connection 类的更多信息,请参见 连接到数据源。有关实现 .NET Framework 数据提供程序的更多信息,请参见 Implementing a .NET Framework Data Provider

应用程序不直接创建 IDbConnection 接口的实例,而是创建继承 IDbConnection 的类的实例。

继承 IDbConnection 的类必须实现所有继承成员,且通常定义更多的成员,以添加提供程序特定的功能。例如,IDbConnection 接口定义 ConnectionTimeout 属性。然后,SqlConnection 类继承此属性,还定义 PacketSize 属性。

给实现者的说明 为提高 .NET Framework 数据提供程序之间的一致性,请命名 PrvClassname 窗体中的继承类,其中 Prv 是给予特定 .NET Framework 数据提供程序命名空间中的所有类的统一前缀。例如,Sql 是 System.Data.SqlClient 命名空间中 SqlConnection 类的前缀。 在从 IDbConnection 接口继承时,应实现下列构造函数:

说明

PrvConnection()

初始化 PrvConnection 类的新实例。

PrvConnection(string connectionString)

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

示例

下面的示例创建派生类 SqlCommandSqlConnection 的实例。SqlConnection 打开,并设置为 SqlCommandConnection。然后,该示例调用 ExecuteNonQuery 并关闭该连接。为了完成此任务,将为 ExecuteNonQuery 传递一个连接字符串和一个查询字符串,后者是一个 Transact-SQL INSERT 语句。

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.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function
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.ConfigurationSettings.AppSettings property 
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0、1.0

请参见

参考

IDbConnection 成员
System.Data 命名空间