OdbcConnection 類別

定義

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

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

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

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

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

type OdbcConnection = class
    inherit DbConnection
    interface ICloneable

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

Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable

繼承

Object

MarshalByRefObject

Component

OdbcConnection

繼承

Object

MarshalByRefObject

Component

DbConnection

OdbcConnection

實作

IDbConnection ICloneable 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 明確關閉任何未開啟OdbcConnection物件，或將連線置於陳述式中Using。 這樣做不會讓這些原生資源釋出垃圾收集。 它可能不會立即釋放它們。 反過來，這最終可能會導致基礎驅動程式耗盡資源或達到上限。 這會導致間歇性失敗。 例如，當許多連線等待被垃圾回收器刪除時，你可能會遇到 Maximum Connections -related 錯誤。 明確關閉連線可讓您更有效率地使用原生資源、增強延展性和改善整體應用程式效能。

如果類別中的Execute某個OdbcCommand方法導致致命（OdbcException例如SQL Server嚴重度等級達20或以上），可能會OdbcConnection關閉。 不過，使用者可以重新開啟連線並繼續使用。

建立物件實例 OdbcConnection 的應用程式可以透過設定宣告式或命令式安全要求，要求所有直接與間接呼叫者對程式碼擁有足夠的權限。 OdbcConnection 使用物件 OdbcPermission 會產生安全需求。 使用者可以透過使用物件 OdbcPermissionAttribute 來驗證其程式碼是否擁有足夠的權限。 使用者與管理員也可使用程式碼存取安全政策工具（Caspol.exe）在電腦、使用者及企業層級修改安全政策。 如需詳細資訊，請參閱 Code Access Security and ADO.NET。

欲了解更多關於處理來自資料來源的警告與資訊訊息的資訊，請參閱 連線事件。

另請參閱

• 連接資料來源