OleDbConnection.ReleaseObjectPool Méthode

Définition

Espace de noms:
System.Data.OleDb
Assembly:
System.Data.dll

Indique que le OleDbConnection pool d’objets peut être libéré lorsque la dernière connexion sous-jacente est publiée.

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

Exemples

L’exemple suivant crée un OleDbConnectionobjet , l’ouvre, affiche certaines de ses propriétés, ferme la connexion et libère le pool d’objets pour conserver les ressources.

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

Remarques

ReleaseObjectPool peut être appelé pour libérer des ressources qui seraient autrement réservées aux objets mis en OleDbConnection pool. Vous pouvez appeler cette méthode si, par exemple, l’objet de connexion ne sera pas utilisé à nouveau pendant la durée pendant laquelle les services OLE DB conservent généralement les connexions mises en pool actives. Notez que l’appel de la méthode seul ne libère pas réellement les connexions actives qui existent dans le pool.

Les éléments suivants doivent se produire avant la suppression du pool :

  1. Appelez Close pour renvoyer l’objet de connexion au pool.

  2. Autoriser chaque objet de connexion à expirer du pool.

  3. Appelez ReleaseObjectPool.

  4. Appelez garbage collection.

À l’inverse, si vous appelez Close toutes les connexions actives et appelez le garbage collection, mais que vous n’appelez ReleaseObjectPoolpas, les ressources réservées aux objets mis en pool restent disponibles.

S’applique à

Voir aussi