Using-Anweisung (Visual Basic)

Deklariert den Beginn eines Using-Blocks und ruft optional die Systemressourcen ab, die von dem Block gesteuert werden.

Using { resourcelist | resourceexpression }
    [ statements ]
End Using

Teile

Jede Ressource im resourcelist-Teil weist die folgende Syntax und die folgenden Bestandteile auf:

resourcename As New resourcetype [ ( [ arglist ] ) ]

- oder -

resourcename As resourcetype = resourceexpression

Bestandteile von "resourcelist"

Hinweise

Zuweilen erfordert Code eine nicht verwaltete Ressource, z. B. ein Dateihandle, einen COM-Wrapper oder eine SQL-Verbindung.Mit einem Using-Block wird die Freigabe einer oder mehrerer dieser Ressourcen nach ihrer Behandlung durch den Code sichergestellt.Hierdurch werden sie für die Verwendung durch anderen Code verfügbar.

Verwaltete Ressourcen werden vom Garbage Collector (GC) von .NET Framework freigegeben. Sie müssen hierfür keinen zusätzlichen Code schreiben.Für verwaltete Ressourcen ist kein Using-Block erforderlich.Dennoch können Sie einen Using-Block verwenden, um die Beseitigung einer verwalteten Ressource zu erzwingen anstatt auf den Garbage Collector zu warten.

Ein Using-Block besteht aus drei Teilen: Abruf, Verwendung und Freigabe.

• Abruf bedeutet, dass eine Variable erstellt und für den Verweis auf die Systemressource initialisiert wird.Die Using-Anweisung kann eine oder mehrere Ressourcen abrufen. Sie können auch genau eine Ressource abrufen, bevor der Block ausgeführt wird, und sie für die Using-Anweisung bereitstellen.Wenn Sie resourceexpression angeben, müssen Sie die Ressource abrufen, bevor die Steuerung an die Using-Anweisung übergeben wird.

• Verwendung bedeutet, dass auf die Ressourcen zugegriffen wird und Aktionen mit ihnen ausgeführt werden.Die Anweisungen zwischen Using und End Using stellen die Verwendung der Ressourcen dar.

• Freigabe bedeutet, dass für das Objekt in resourcename die Dispose-Methode aufgerufen wird.Dies ermöglicht dem Objekt, seine Ressourcen sauber zu beenden.Mit der End Using-Anweisung werden die vom Using-Block gesteuerten Ressourcen freigegeben.

Verhalten

Das Verhalten eines Using-Blocks entspricht dem Verhalten einer Try...Finally-Konstruktion, in deren Try-Block die Ressourcen verwendet und in deren Finally-Block die Ressourcen freigegeben werden.Aus diesem Grund wird die Freigabe der Ressourcen durch den Using-Block sichergestellt, unabhängig davon, wie Sie den Block beenden.Dies gilt sogar im Fall einer nicht behandelten Ausnahme, allerdings nicht bei einer StackOverflowException.

Der Gültigkeitsbereich jeder von der Using-Anweisung abgerufenen Ressourcenvariablen ist auf den Using-Block beschränkt.

Wenn Sie in der Using-Anweisung mehrere Systemressourcen angeben, hat dies dieselbe Auswirkung wie das Schachteln mehrerer Using-Blocks.

Wenn resourcenameNothing ist, wird kein Aufruf Dispose gemacht, und es wird keine Ausnahme ausgelöst.

Strukturierte Ausnahmebehandlung in einem Using-Block

Wenn Sie eine Ausnahme behandeln müssen, die möglicherweise in einem Using-Block auftritt, können Sie diesem eine vollständige Try...Finally-Konstruktion hinzufügen.Wenn Sie den Fall behandeln müssen, dass eine Ressource von einer Using-Anweisung nicht erfolgreich abgerufen wird, können Sie überprüfen, ob resourcenameNothing ist.

Strukturierte Ausnahmebehandlung anstelle eines Using-Blocks

Wenn Sie den Abruf der Ressourcen genauer steuern müssen oder wenn im Finally-Block zusätzlicher Code erforderlich ist, können Sie den Using-Block in eine Try...Finally-Konstruktion ändern.Im folgenden Beispiel werden die Skelette einer Try-Konstruktion und einer Using-Konstruktion veranschaulicht, die dem Abruf und der Freigabe von resource entsprechen.

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 

Hinweis
Der Code im Using-Block darf das Objekt in resourcename keiner anderen Ressource zuweisen.Beim Beenden des Using-Blocks wird die Ressource freigegeben, und die andere Variable kann nicht auf die Ressource zugreifen, auf die sie zeigt.

Beispiel

Im folgenden Beispiel wird eine Datei mit dem Namen log.txt, und schreibt zwei Textzeilen zur Datei.Außerdem liest dass dieselbe Datei und zeigt die Textzeilen an.

Da die TextWriter und TextReader-Klassen die IDisposable-Schnittstelle implementieren, kann der Code Using-Anweisungen verwenden, um sicherzustellen, dass die Datei ordnungsgemäß nach dem geschriebene und die Lesevorgänge geschlossen wird.

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

Siehe auch

Aufgaben

Gewusst wie: Freigeben einer Systemressource (Visual Basic)

Referenz

IDisposable

Try...Catch...Finally-Anweisung (Visual Basic)