Using, instruction (Visual Basic)

Déclare le début d’un Using bloc et acquiert éventuellement les ressources système que le bloc contrôle.

Syntaxe

Using { resourcelist | resourceexpression }
    [ statements ]
End Using

Pièces

Chaque ressource du resourcelist composant a la syntaxe et les parties suivantes :

resourcename As New resourcetype [ ( [ arglist ] ) ]

- ou -

resourcename As resourcetype = resourceexpression

composants resourcelist

Remarques

Parfois, votre code nécessite une ressource non managée, telle qu’un handle de fichier, un wrapper COM ou une connexion SQL. Un Using bloc garantit l’élimination d’une ou plusieurs ressources de ce type lorsque votre code est terminé avec eux. Cela les rend disponibles pour que d’autres codes soient utilisés.

Les ressources managées sont supprimées par le garbage collector .NET Framework (GC) sans code supplémentaire de votre part. Vous n’avez pas besoin d’un Using bloc pour les ressources managées. Toutefois, vous pouvez toujours utiliser un Using bloc pour forcer l’élimination d’une ressource managée au lieu d’attendre le garbage collector.

Un Using bloc comporte trois parties : l’acquisition, l’utilisation et la suppression.

• L’acquisition signifie créer une variable et l’initialiser pour faire référence à la ressource système. L’instruction Using peut acquérir une ou plusieurs ressources, ou vous pouvez acquérir exactement une ressource avant d’entrer le bloc et de le fournir à l’instruction Using . Si vous fournissez resourceexpression, vous devez acquérir la ressource avant de passer le contrôle à l’instruction Using .

• L’utilisation signifie accéder aux ressources et effectuer des actions avec elles. Les instructions entre Using et End Using représentent l’utilisation des ressources.

• La suppression signifie appeler la Dispose méthode sur l’objet dans resourcename. Cela permet à l’objet de mettre fin correctement à ses ressources. L’instruction End Using supprime les ressources sous le Using contrôle du bloc.

Comportement

Un Using bloc se comporte comme une Tryconstruction ...Finally dans laquelle le Try bloc utilise les ressources et le Finally bloc les supprime. En raison de cela, le Using bloc garantit l’élimination des ressources, quelle que soit la façon dont vous quittez le bloc. Cela est vrai même dans le cas d’une exception non gérée, à l’exception d’un StackOverflowException.

L’étendue de chaque variable de ressource acquise par l’instruction Using est limitée au Using bloc.

Si vous spécifiez plusieurs ressources système dans l’instruction Using , l’effet est identique à celui que vous avez imbriqué Using dans un autre.

Si resourcename c’est Nothingle cas, aucun appel n’est Dispose effectué et aucune exception n’est levée.

Gestion des exceptions structurées au sein d’un bloc using

Si vous devez gérer une exception qui peut se produire dans le Using bloc, vous pouvez y ajouter une construction complèteTry...Finally Si vous devez gérer le cas où l’instruction Using n’a pas réussi à acquérir une ressource, vous pouvez tester si c’est le cas resourcenameNothing.

Gestion des exceptions structurées au lieu d’un bloc d’utilisation

Si vous avez besoin d’un Trycontrôle plus fin sur l’acquisition des ressources, ou si vous avez besoin d’un code supplémentaire dans le Finally bloc, vous pouvez réécrire le Using bloc en tant que construction ...Finally L’exemple suivant montre des squelettes Try et Using des constructions équivalentes à l’acquisition et à l’élimination de resource.

Using resource As New resourceType
    ' Insert code to work with resource.
End Using

' For the acquisition and disposal of resource, the following  
' Try construction is equivalent to the Using block.
Dim resource As New resourceType
Try
    ' Insert code to work with resource.
Finally
    If resource IsNot Nothing Then
        resource.Dispose()
    End If
End Try

Exemple :

L’exemple suivant crée un fichier nommé log.txt et écrit deux lignes de texte dans le fichier. L’exemple lit également ce même fichier et affiche les lignes de texte :

Étant donné que les TextWriter classes implémentent TextReader l’interface IDisposable , le code peut utiliser Using des instructions pour s’assurer que le fichier est correctement fermé après les opérations d’écriture et de lecture.

Private Sub WriteFile()
    Using writer As System.IO.TextWriter = System.IO.File.CreateText("log.txt")
        writer.WriteLine("This is line one.")
        writer.WriteLine("This is line two.")
    End Using
End Sub

Private Sub ReadFile()
    Using reader As System.IO.TextReader = System.IO.File.OpenText("log.txt")
        Dim line As String

        line = reader.ReadLine()
        Do Until line Is Nothing
            Console.WriteLine(line)
            line = reader.ReadLine()
        Loop
    End Using
End Sub

Voir aussi

• IDisposable
• Instruction Try...Catch...Finally
• Procédure : supprimer une ressource système