Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Libération des ressources

La libération des ressources est un nettoyage contrôlé qui intervient quand une ressource n’est plus nécessaire. En mode synchrone, `using` peut appeler `IDisposable.Dispose` ou, pour un type `ref struct`, une méthode `Dispose` conforme au modèle de libération, même si le type n’implémente pas `IDisposable`. Pour un nettoyage asynchrone via `IAsyncDisposable.DisposeAsync`, utilisez `await using`. Les deux constructions assurent le nettoyage à la sortie de la portée, même en cas d’exception. Cette opération se distingue de la récupération de mémoire par le GC.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

using (Resource resource = new Resource()) { /* use resource */ }
using Resource resource = new Resource();
await using AsyncResource resource = new AsyncResource();

La libération des ressources (resource disposal) est un nettoyage contrôlé, comme la fermeture d’un fichier ou la libération d’un handle. IDisposable.Dispose est une méthode sans paramètre qui renvoie void et effectue ce nettoyage. Le GC récupère la mémoire managée, mais n’appelle pas automatiquement Dispose. Le simple fait qu’une variable ordinaire sorte de portée ne libère pas sa ressource.

Une instruction using (...) { ... } libère sa ressource à la sortie de son bloc. Une déclaration using var resource = ...; le fait à la sortie de la portée qui l’englobe. Le compilateur assure une sémantique try/finally : cela couvre aussi return et la propagation d’une exception. Plusieurs ressources sont libérées dans l’ordre inverse de leur déclaration ; si la valeur est null, l’appel est omis.

Libérez les ressources dont vous gérez la durée de vie ; ne libérez pas un objet simplement parce que vous en avez reçu une référence. Après la libération, n’utilisez plus la ressource, sauf si sa documentation l’autorise explicitement. Une implémentation de Dispose doit tolérer les appels répétés. Un finaliseur est un mécanisme distinct, au moment d’exécution non déterministe, et non un remplacement de using.

Pour un nettoyage asynchrone via IAsyncDisposable.DisposeAsync, utilisez await using ; un using ordinaire n’attend pas la fin du nettoyage asynchrone. L’exemple utilise IDisposable de façon synchrone : DemoResource simule simplement le nettoyage par un message. Disposed apparaît avant Caught, car le nettoyage a lieu à la sortie de la portée try.

Exemples

using System;

try
{
    using var resource = new DemoResource();
    Console.WriteLine("Working");
    throw new InvalidOperationException("Demo");
}
catch (InvalidOperationException)
{
    Console.WriteLine("Caught");
}

sealed class DemoResource : IDisposable
{
    private bool disposed;

    public void Dispose()
    {
        if (disposed)
            return;

        disposed = true;
        Console.WriteLine("Disposed");
    }
}

Résultat

Working
Disposed
Caught

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources