OdbcConnection 类

定义

命名空间:

System.Data.Odbc

程序集:

System.Data.Odbc.dll

包:

System.Data.Odbc v8.0.0

Source:

OdbcConnection.cs

表示到数据源的连接是打开的。

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

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

type OdbcConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable

继承

Object

DbConnection

OdbcConnection

实现

ICloneable

示例

以下示例创建 OdbcCommand 和 OdbcConnection。 OdbcConnection将 打开并设置为 Connection 属性。 然后，该示例调用 ExecuteNonQuery并关闭连接。 为此，向 ExecuteNonQuery 传递连接字符串和作为 SQL INSERT 语句的查询字符串。

static private void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
    OdbcCommand command = new OdbcCommand(queryString);

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        command.Connection = connection;
        connection.Open();
        command.ExecuteNonQuery();

        // The connection is automatically closed at
        // the end of the Using block.
    }
}

Private Sub InsertRow(ByVal connectionString As String)

    Dim queryString As String = _
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
    Dim command As New OdbcCommand(queryString)

    Using connection As New OdbcConnection(connectionString)
        command.Connection = connection
        connection.Open()
        command.ExecuteNonQuery()

        ' The connection is automatically closed at 
        ' the end of the Using block.
    End Using
End Sub

注解

对象OdbcConnection表示使用 DSN) (连接字符串或 ODBC 数据源名称创建的数据源的唯一连接。 对于客户端/服务器数据库系统，它等效于与服务器的网络连接。 根据本机 ODBC 驱动程序支持的功能，对象的某些 OdbcConnection 方法或属性可能不可用。

对象 OdbcConnection 使用本机资源，如 ODBC 环境和连接句柄。 应始终显式关闭任何打开OdbcConnection的对象，方法是在对象超出范围之前OdbcConnection调用 Close 或 Dispose，或者在 语句中Using放置连接。 如果不这样做，会释放这些本机资源进行垃圾回收。 它可能不会立即释放他们。 这反过来又可能导致基础驱动程序的资源耗尽或达到最大限制。 这导致了间歇性故障。 例如，在等待垃圾回收器删除许多连接时，可能会遇到 Maximum Connections 与 相关的错误。 显式关闭连接可以更有效地使用本机资源，增强可伸缩性并提高应用程序的整体性能。

注意

若要部署高性能应用程序，必须经常使用连接池。 但是，使用适用于 ODBC 的 .NET Framework 数据提供程序时，不必启用连接池，因为提供程序会自动管理此连接池。

如果 类的方法ExecuteOdbcCommand之一导致致命 OdbcException (例如，SQL Server严重级别为 20 或更高) ，则 OdbcConnection 可能会关闭。 但是，用户可以重新打开连接并继续操作。

创建对象实例 OdbcConnection 的应用程序可以要求所有直接和间接调用方通过设置声明性或命令性安全要求来对代码具有足够的权限。 OdbcConnection 使用 OdbcPermission 对象创建安全要求。 用户可以使用 对象验证其代码是否具有足够的权限 OdbcPermissionAttribute 。 用户和管理员还可以使用代码访问安全策略工具 (Caspol.exe) 在计算机、用户和企业级别修改安全策略。 有关更多信息，请参见 Code Access Security and ADO.NET。

有关处理来自数据源的警告和信息性消息的详细信息，请参阅 连接事件。

构造函数

OdbcConnection()	初始化 OdbcConnection 类的新实例。
OdbcConnection(String)	使用指定的连接字符串初始化 OdbcConnection 类的新实例。

属性

CanCreateBatch	获取一个值，该值指示此 DbConnection 是否支持 DbBatch 类。 (继承自 DbConnection)
ConnectionString	获取或设置用于打开数据源的字符串。
ConnectionTimeout	获取或设置在尝试建立连接时终止尝试并生成错误之前所等待的时间（以秒为单位）。
Database	获取当前数据库的名称或打开连接后要使用的数据库的名称。
DataSource	获取数据源的服务器名或文件名。
DbProviderFactory	获取此 DbProviderFactory 的 DbConnection。 (继承自 DbConnection)
Driver	获取为当前连接指定的 ODBC 驱动程序名称。
ServerVersion	获取一个包含客户端所连接到的服务器的版本的字符串。
State	获取连接的当前状态。

方法

BeginDbTransaction(IsolationLevel)	在派生类中重写时，启动数据库事务。 (继承自 DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	异步启动数据库事务。 (继承自 DbConnection)
BeginTransaction()	在数据源中开始事务。
BeginTransaction(IsolationLevel)	在数据源中用指定的 IsolationLevel 值开始事务。
BeginTransactionAsync(CancellationToken)	异步开始数据库事务。 (继承自 DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	异步开始数据库事务。 (继承自 DbConnection)
ChangeDatabase(String)	更改与打开的 OdbcConnection 关联的当前数据库。
ChangeDatabaseAsync(String, CancellationToken)	为打开的连接对象异步更改当前数据库。 (继承自 DbConnection)
Close()	关闭到数据源的连接。
CloseAsync()	异步关闭与数据库之间的连接。 (继承自 DbConnection)
CreateBatch()	返回实现 DbBatch 类的提供程序类的一个新实例。 (继承自 DbConnection)
CreateCommand()	创建并返回一个与该 OdbcCommand 关联的 OdbcConnection 对象。
CreateDbBatch()	在派生类中重写时，返回实现 DbBatch 类的提供程序类的新实例。 (继承自 DbConnection)
CreateDbCommand()	在派生类中重写时，创建并返回与当前连接关联的 DbCommand 对象。 (继承自 DbConnection)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 DbConnection)
Dispose(Boolean)	释放由 DbConnection 占用的非托管资源，还可以另外再释放托管资源。 (继承自 DbConnection)
DisposeAsync()	异步处置连接对象。 (继承自 DbConnection)
EnlistTransaction(Transaction)	在指定事务中登记。 (继承自 DbConnection)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetSchema()	返回此 OdbcConnection 的数据源的架构信息。
GetSchema(String)	使用架构名称的指定名称，返回此 OdbcConnection 的数据源的架构信息。
GetSchema(String, String[])	通过使用指定字符串作为架构名称，指定字符串数组作为限制值，返回此 OdbcConnection 的数据源的架构信息。
GetSchemaAsync(CancellationToken)	这是 GetSchema() 的异步版本。 提供程序应使用合适的实现进行重写。 可以选择接受 cancellationToken。 默认实现调用同步 GetSchema() 调用并返回已完成任务。 如果传递到已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchema() 引发的异常将通过任务异常属性传递。 (继承自 DbConnection)
GetSchemaAsync(String, CancellationToken)	这是 GetSchema(String) 的异步版本。 提供程序应使用合适的实现进行重写。 可以选择接受 cancellationToken。 默认实现调用同步 GetSchema(String) 调用并返回已完成任务。 如果传递到已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchema(String) 引发的异常将通过任务异常属性传递。 (继承自 DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	这是 GetSchema(String, String[]) 的异步版本。 提供程序应使用合适的实现进行重写。 可以选择接受 cancellationToken。 默认实现调用同步 GetSchema(String, String[]) 调用并返回已完成任务。 如果传递到已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchema(String, String[]) 引发的异常将通过任务异常属性传递。 (继承自 DbConnection)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnStateChange(StateChangeEventArgs)	引发 StateChange 事件。 (继承自 DbConnection)
Open()	使用 ConnectionString 指定的属性设置打开到数据源的连接。
OpenAsync()	Open()的异步版本，打开由 ConnectionString指定的设置的数据库连接。 此方法通过 CancellationToken.None 调用虚拟方法 OpenAsync(CancellationToken)。 (继承自 DbConnection)
OpenAsync(CancellationToken)	这是 Open() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性接受取消标记。 默认实现调用同步 Open() 调用并返回已完成任务。 如果传递到已取消的取消标记，则默认实现将返回已取消的 cancellationToken。 Open 引发的异常将通过返回的任务异常属性传递。 在返回的任务完成前，不要调用 DbConnection 对象的其他方法和属性。 (继承自 DbConnection)
ReleaseObjectPool()	指示当释放最后的基础连接时可以释放 ODBC 驱动程序管理器环境句柄。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

InfoMessage	在 ODBC 驱动程序发送警告或信息性消息时发生。
StateChange	当连接状态改变时发生。 (继承自 DbConnection)

显式接口实现

ICloneable.Clone()

有关此成员的说明，请参见 Clone()。

另请参阅

• 连接到数据源