OleDbConnection.ReleaseObjectPool Metoda

Definice

Označuje, že OleDbConnection fond objektů může být uvolněn při uvolnění posledního základního připojení.Indicates that the OleDbConnection object pool can be released when the last underlying connection is released.

public:
 static void ReleaseObjectPool();
public static void ReleaseObjectPool ();
static member ReleaseObjectPool : unit -> unit
Public Shared Sub ReleaseObjectPool ()

Příklady

Následující příklad vytvoří OleDbConnection , otevře, zobrazí některé jeho vlastnosti, zavře připojení a uvolní fond objektů pro účely úspory prostředků.The following example creates an OleDbConnection, opens it, displays some of its properties, closes the connection, and releases the object pool to conserve resources.

static void OpenConnection(string connectionString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        try
        {
            connection.Open();
            Console.WriteLine("Connection.State: {0}", connection.State);

            connection.Close();
            OleDbConnection.ReleaseObjectPool();
            Console.WriteLine("Connection.State: {0}", connection.State);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}
Public Sub OpenConnection(ByVal connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Try
            connection.Open()
            Console.WriteLine("Connection.State: {0}", _
                connection.State)

            connection.Close()
            OleDbConnection.ReleaseObjectPool()
            Console.WriteLine("Connection.State: {0}", _
                connection.State)

        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

Poznámky

ReleaseObjectPool dá se zavolat, aby se uvolnily prostředky, které by jinak byly rezervované pro objekty ve fondu OleDbConnection .ReleaseObjectPool can be called to free resources that would otherwise be reserved for pooled OleDbConnection objects. Tuto metodu můžete chtít volat, pokud například objekt připojení nebude znovu použit po dobu, po kterou OLE DB služby běžně udržuje připojení ve fondu aktivní.You might want to call this method if, for example, the connection object will not be used again for the amount of time that OLE DB services ordinarily keeps pooled connections active. Všimněte si, že volání samotné metody ve skutečnosti neuvolní aktivní připojení, která existují ve fondu.Note that calling the method alone does not actually release the active connections that exist in the pool.

Aby byl fond nakonec vyřazený, musí dojít k následujícímu:The following must occur before the pool is finally disposed:

  1. Voláním Close vrátíte objekt připojení do fondu.Call Close to return the connection object to the pool.

  2. Povolí časový limit každého objektu připojení z fondu.Allow each connection object to time out of the pool.

  3. Volání ReleaseObjectPool .Call ReleaseObjectPool.

  4. Vyvolat uvolňování paměti.Invoke garbage collection.

Pokud naopak zavoláte Close na všechna aktivní připojení a vyvoláte uvolňování paměti, ale nebudete volat ReleaseObjectPool , zůstanou prostředky rezervované pro objekty ve fondu k dispozici.Conversely, if you call Close on all active connections, and invoke garbage collection, but do not call ReleaseObjectPool, the resources reserved for the pooled objects will remain available.

Platí pro