Freigeben über

OdbcConnection.Close-Methode

Schließt die Verbindung mit der Datenquelle.

Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Sub Close
'Usage
Dim instance As OdbcConnection

instance.Close

public override void Close ()

public:
virtual void Close () override

public void Close ()

public override function Close ()

Hinweise

Die Close-Methode führt für alle anstehenden Transaktionen einen Rollback aus. Anschließend gibt sie die Verbindung für den Verbindungspool frei oder schließt die Verbindung, wenn das Verbindungspooling deaktiviert ist. Wenn Close während der Behandlung eines StateChange-Ereignisses aufgerufen wird, werden keine zusätzlichen StateChange-Ereignisse ausgelöst.

Anwendungen können Close mehrmals aufrufen, ohne dass eine Ausnahme ausgelöst wird.

Hinweis

Wenn Sie den .NET Framework-Datenanbieter für ODBC verwenden, müssen Sie das Verbindungspooling nicht aktivieren, da dieses vom ODBC-Treiber-Manager automatisch verwaltet wird. Weitere Informationen über das Aktivieren und das Deaktivieren des Verbindungspoolings finden Sie in der Dokumentation zu Microsoft Open Database Connectivity (ODBC).

Warnung

Für ein Connection-Objekt, ein DataReader-Objekt oder ein anderes verwaltetes Objekt dürfen Close oder Dispose nicht in der Finalize-Methode der Klasse aufgerufen werden. In einem Finalizer dürfen Sie nur nicht verwaltete Ressourcen freigeben, die im direkten Besitz der Klasse sind. Wenn die Klasse keine nicht verwalteten Ressourcen besitzt, nehmen Sie keine Finalize-Methode in die Klassendefinition auf. Weitere Informationen finden Sie unter Garbage Collection.

Beispiel

Im folgenden Beispiel wird eine OdbcConnection erstellt und geöffnet, einige ihrer Eigenschaften werden angezeigt, und anschließend wird die Verbindung geschlossen.

Private Sub CreateOdbcConnection(ByVal connectionString As String)
    Using connection As New OdbcConnection(connectionString)
        With connection
            .Open()
            Console.WriteLine("ServerVersion: " & .ServerVersion _
               & vbCrLf + "Database: " & .Database)
        End With

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

private static void CreateOdbcConnection(string connectionString)
{
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDatabase: " + connection.Database);

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OdbcConnection-Klasse
OdbcConnection-Member
System.Data.Odbc-Namespace

Weitere Ressourcen

Herstellen von Verbindungen zu Datenquellen

  • Last updated on