OdbcConnection 类

定义

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

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

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

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

type OdbcConnection = class
    inherit DbConnection
    interface ICloneable

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

Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable

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

继承

Object

MarshalByRefObject

Component

DbConnection

OdbcConnection

继承

Object

MarshalByRefObject

Component

OdbcConnection

实现

ICloneable IDbConnection IDisposable

示例

以下示例创建一个 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 对象表示与使用连接字符串或 ODBC 数据源名称（DSN）创建的数据源的唯一连接。 使用客户端/服务器数据库系统时，它等效于与服务器的网络连接。 根据本机 ODBC 驱动程序支持的功能，OdbcConnection 对象的某些方法或属性可能不可用。

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

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

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

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

构造函数

属性

方法

事件

显式接口实现

扩展方法

适用于

另请参阅

• 连接到数据源