C# Using Statement (Comment ça fonctionne pour les développeurs)

Syntaxe et Utilisation

L'instruction using simplifie le processus de libération des ressources non gérées. Elle garantit que la méthode Dispose est appelée sur un objet jetable dès que l'objet sort de la portée.

Pensez au bloc using comme à une zone de sécurité qui s'assure que les ressources sont automatiquement nettoyées après utilisation. Voici un exemple de base pour illustrer son utilisation :

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
    // When the block is exited, the StreamReader's Dispose method is automatically called.
}

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
    // When the block is exited, the StreamReader's Dispose method is automatically called.
}

Using reader As New StreamReader("file.txt")
	' You can read the file here
	' When the block is exited, the StreamReader's Dispose method is automatically called.
End Using

Dans l'exemple ci-dessus, StreamReader est une classe qui implémente l'interface IDisposable. L'instruction using garantit que la méthode Dispose du lecteur est appelée automatiquement lorsque le contrôle quitte la portée définie par les accolades.

Comment ça marche

Lorsque vous emballez un objet jetable avec une instruction using, cela se traduit essentiellement par un bloc try avec un bloc finally. Dans le bloc finally, la méthode Dispose est appelée, garantissant que la ressource est correctement libérée même si une exception se produit.

Si le code à l'intérieur du bloc using jette une erreur, ne vous inquiétez pas; la méthode Dispose sera toujours appelée, garantissant que les ressources sont libérées en toute sécurité.

Gestion de Plusieurs Ressources

Vous pouvez gérer plusieurs objets jetables dans une seule instruction using. Cette approche garde votre code plus propre et assure que toutes les ressources sont correctement libérées :

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
    // Both conn and cmd will be disposed of when the block is exited.
}

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
    // Both conn and cmd will be disposed of when the block is exited.
}

Using conn As New SqlConnection(connString)
Using cmd As New SqlCommand(query, conn)
	' Work with your database here
	' Both conn and cmd will be disposed of when the block is exited.
End Using
End Using

Directive d'Aliasing Using

En plus des fonctionnalités principales de l'instruction using, C# offre des fonctionnalités comme la directive d'alias using et la gestion efficace des variables locales dans les blocs using pour simplifier davantage la gestion des ressources et améliorer la lisibilité du code.

Parfois, lorsque vous travaillez avec des bibliothèques externes ou lorsque vous traitez des conflits de noms de classe, notre code peut devenir encombré et difficile à suivre. La directive d'alias using vient à la rescousse en nous permettant d'assigner un alias plus lisible ou plus court à un espace de noms ou à une classe.

Considérons un scénario où vous travaillez avec deux classes différentes portant le même nom mais résidant dans des espaces de noms différents. Vous pouvez utiliser la directive d'alias using pour les différencier facilement :

using Project = FirstNamespace.Project;
using ExternalProject = SecondNamespace.Project;

// Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

using Project = FirstNamespace.Project;
using ExternalProject = SecondNamespace.Project;

// Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

Imports Project = FirstNamespace.Project
Imports ExternalProject = SecondNamespace.Project

' Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

La Déclaration Using

Introduite dans C# 8.0, la déclaration using est un sucre syntaxique qui rend votre code encore plus concis. Au lieu d'envelopper l'objet jetable avec des accolades, vous pouvez le déclarer, et il sera libéré à la fin de la portée où il a été déclaré :

using StreamReader reader = new StreamReader("file.txt");
// Use reader here
// It will be disposed of here automatically at the end of the scope.

using StreamReader reader = new StreamReader("file.txt");
// Use reader here
// It will be disposed of here automatically at the end of the scope.

Using reader As New StreamReader("file.txt")
	' Use reader here
	' It will be disposed of here automatically at the end of the scope.
End Using

Classes Personnalisées et IDisposable

Vous pouvez également appliquer l'instruction using aux classes personnalisées en implémentant l'interface IDisposable. Ceci est particulièrement utile lorsque votre classe est responsable de la gestion d'une ou plusieurs ressources :

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Code to release your resources here
    }
}

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Code to release your resources here
    }
}

Public Class ResourceHolder
	Implements IDisposable

	Public Sub Dispose() Implements IDisposable.Dispose
		' Code to release your resources here
	End Sub
End Class

Avec votre classe implémentant IDisposable, vous pouvez alors l'utiliser dans une instruction using tout comme n'importe quel autre objet jetable.

Installer IronPDF

La manière la plus efficace d'ajouter IronPDF à votre projet est par le gestionnaire de packages NuGet. Ouvrez simplement votre projet dans Visual Studio, allez à "Explorateur de solutions", clic droit sur "Dépendances", et choisissez "Gérer les packages NuGet". Ici, vous pouvez rechercher "IronPdf" et installer le package en quelques clics seulement.

Exemple d'Utilisation d'IronPDF avec l'Instruction Using

Revenons à l'instruction using en C# pour la gestion des ressources. Ci-dessous un simple exemple de code démontrant comment utiliser IronPDF pour générer un PDF à partir de contenu HTML, en employant l'instruction using pour garantir la libération correcte des ressources :

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML string and save it
        using (var document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>"))
        {
            document.SaveAs("HelloIronPDF.pdf");
        }
        // The using statement ensures that resources are cleaned up correctly
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML string and save it
        using (var document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>"))
        {
            document.SaveAs("HelloIronPDF.pdf");
        }
        // The using statement ensures that resources are cleaned up correctly
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' Generate a PDF from HTML string and save it
		Using document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>")
			document.SaveAs("HelloIronPDF.pdf")
		End Using
		' The using statement ensures that resources are cleaned up correctly
	End Sub
End Class

Licence

IronPDF propose une variété d'options de licences pour des besoins variés afin de s'adapter à différentes tailles d'équipes et besoins de déploiement, garantissant une flexibilité pour les développeurs et organisations de toutes tailles.

Le prix de la licence commence à partir de $799. Il propose une version d'essai gratuite des fonctionnalités d'IronPDF pour tester ses fonctionnalités avant l'achat.