Using-Anweisung (Visual Basic)

Artikel
09/02/2008

Aktualisiert: November 2007

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

Using { resourcelist | resourceexpression }
    [ statements ]
End Using

Bestandteile

resourcelist
Erforderlich, wenn Sie resourceexpression nicht angeben. Liste mit einer oder mehreren Systemressourcen, die von diesem Using-Block gesteuert werden.
resourceexpression
Erforderlich, wenn Sie resourcelist nicht angeben. Verweisvariable oder -ausdruck, die bzw. der auf eine Systemressource verweist, die von diesem Using-Block gesteuert werden soll.
statements
Optional. Block von Anweisungen, die vom Using-Block ausgeführt werden.
End Using
Erforderlich. Beendet die Definition des Using-Blocks und gibt alle Ressourcen frei, die von dem Block gesteuert werden.

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"

resourcename
Erforderlich. Verweisvariable, die auf eine vom Using-Block gesteuerte Systemressource verweist.
New
Erforderlich, wenn die Using-Anweisung die Ressource abruft. Wenn Sie die Ressource bereits abgerufen haben, verwenden Sie die zweite Alternative der Syntax.
resourcetype
Erforderlich. Die Klasse der Ressource. Die Klasse muss die IDisposable-Schnittstelle implementieren.
arglist
Optional. Liste der Argumente, die Sie an den Konstruktor übergeben, um eine Instanz von resourcetype zu erstellen. Siehe Parameterliste.
resourceexpression
Erforderlich. Variable oder Ausdruck, der bzw. die auf eine Systemressource verweist, die die Anforderungen von resourcetype erfüllt. Wenn Sie die zweite Alternative der Syntax verwenden, müssen Sie die Ressource abrufen, bevor die Steuerung an die Using-Anweisung übergeben wird.

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.

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 es dem Objekt, die nicht verwaltete Ressource ordnungsgemäß 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.

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
' THE FOLLOWING TRY CONSTRUCTION IS EQUIVALENT TO THE USING BLOCK
Dim resource As New resourceType
Try 
    ' Insert code to work with resource.
Catch ex As Exception
    ' Insert code to process exception.
Finally 
    ' Insert code to do additional processing before disposing of resource.
    resource.Dispose()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 ein Using-Block verwendet, um eine neue Schriftart abzurufen. Hierdurch wird sichergestellt, dass das System die Dispose-Methode für die Schriftart aufruft, wenn der Code den Block beendet.

Public Sub setbigbold(ByVal c As Control)
    Using nf As New System.Drawing.Font("Arial", 12.0F, _
        System.Drawing.FontStyle.Bold)

        c.Font = nf
        c.Text = "This is 12-point Arial bold"
    End Using
End Sub