Using — Instrukcja (Visual Basic)

Oświadcza na początku Using bloku i opcjonalnie nabywa zasobów systemowych, które kontroluje bloku.

Using { resourcelist | resourceexpression }
    [ statements ]
End Using

Części

Każdy zasób w resourcelist część ma następującą składnię i części:

resourcename As New resourcetype [ ( [ arglist ] ) ]

-lub-

resourcename As resourcetype = resourceexpression

Części resourcelist

Uwagi

Czasami kodu wymaga niezarządzanym zasobem, dojście do pliku, otoki COM lub połączenie SQL.A Using bloku gwarantuje usuwania jednego lub więcej takich zasobów, po wykonaniu kodu z nimi.Udostępnia je na inny kod, aby użyć.

Zarządzane zasoby są usuwane przez moduł garbage collector.NET Framework (GC) bez dodatkowych kodowania z Twojej strony.Nie trzeba Using bloku dla zarządzanych zasobów.Jednak nadal można używać Using bloku do wymuszenia usuwania zarządzanego zasobu zamiast czekać na garbage collector.

A Using blok ma trzy części: nabycie, użytkowania i usuwania.

• Nabycie oznacza utworzenie zmiennej i Inicjowanie to odnosi się do zasobów systemu.Using Instrukcja można nabyć jeden lub więcej zasobów, lub można nabyć dokładnie jeden zasób przed wejściem do bloku i dostarczenie jej do Using instrukcji.Jeśli podasz resourceexpression, zasób musi nabyć przed przekazaniem sterowania do Using instrukcji.

• Użycie oznacza dostęp do zasobów i operacji wykonywanych z nimi.Instrukcji między Using i End Using stanowią obciążenie zasobów.

• Usuwanie oznacza wywoływania Dispose metoda obiektu w resourcename.Dzięki temu obiekt czysto zakończyć jego zasobów.End Using Instrukcja zbywa zasobów w ramach Using bloku sterowania.

Zachowanie

A Using bloku zachowuje się jak Try...Finally budowy, w którym Try bloku korzysta z zasobów i Finally bloku usuwa je.W związku z tym Using bloku gwarantuje sprzedaży/likwidacji środków, bez względu na to, jak wyjścia bloku.Ta zasada obowiązuje nawet w przypadku nieobsłużony wyjątek, z wyjątkiem StackOverflowException.

Zakres zmiennej każdego zasobu, nabyte przez Using instrukcja jest ograniczona do Using bloku.

Jeśli określisz więcej niż jeden zasób systemu w Using instrukcji, efekt jest taki sam, jak gdyby można zagnieżdżać Using blokuje jeden w innym.

Jeśli resourcename jest Nothing, nie wezwanie do Dispose jest wykonane, i nie jest wyjątek.

Strukturalnej obsługi w bloku za pomocą wyjątków

Jeśli trzeba obsłużyć wyjątek, który może wystąpić w Using bloku, można dodać kompletne Try...Finally konstrukcji do niego.Jeśli potrzebujesz obsługi w przypadku gdy Using instrukcja nie jest skuteczne w przejmującej zasobu, można sprawdzić, czy resourcename jest Nothing.

Strukturalnej obsługi zamiast przy użyciu bloku wyjątków

Jeśli niezbędna jest ściślejsza kontrola nad nabycia zasobów lub konieczne jest dodatkowy kod w Finally bloku, można napisać ponownie Using blok jako Try...Finally konstrukcji.W poniższym przykładzie przedstawiono szkielet Try i Using konstrukcji, które są równoważne w nabywaniu i sprzedaży aktywów 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 

[!UWAGA]

Kod wewnątrz Using bloku nie należy przypisać obiekt w resourcename do innej zmiennej.Po zakończeniu Using blok, zasób jest usuwane, a inne zmiennej nie może uzyskać dostępu do zasobów, na które wskazuje.

Przykład

Poniższy przykład tworzy plik o nazwie log.txt i zapisuje dwóch wierszy tekstu w pliku.Przykład również odczytuje ten sam plik i wyświetla wiersze tekstu.

Bo TextWriter i TextReader Implementacja klasy IDisposable interfejs, można użyć kodu Using instrukcji w celu zapewnienia, że plik jest poprawnie zamknięty po zapisie i operacji odczytu.

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

Zobacz też

Zadania

Porady: usuwanie zasobu systemu (Visual Basic)

Informacje

IDisposable

Try...Catch...Finally — Instrukcja (Visual Basic)