Control.Dispose Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.

public:
 virtual void Dispose();

public virtual void Dispose();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Overridable Sub Dispose ()

Implementuje

Dispose()

Przykłady

Poniższy przykład kodu zastępuje metodę Dispose w celu zamknięcia HtmlTextWriter obiektu skojarzonego z kontrolką i wywołania Dispose metody w kontrolce Button o nazwie myButton. Jeśli element Exception jest zgłaszany po wywołaniu tej wersji Dispose metody, kontrolka zapisuje komunikat do bieżącego HttpResponse obiektu.

public override void Dispose()
{
   try
   {
      Context.Response.Write("Disposing " + ToString());
      // Perform resource cleanup.
      myTextWriter.Close();
      myButton.Dispose();
   }
   catch(Exception myException)
   {
      Context.Response.Write("Exception occurred: "+myException.Message);
   }
}

Public Overrides Sub Dispose()
   Try
      Context.Response.Write("Disposing " & ToString())
      ' Perform resource cleanup.
      myTextWriter.Close()
      myButton.Dispose()
   Catch myException As Exception
      Context.Response.Write("Exception occurred: " & myException.Message)
   End Try
End Sub

Uwagi

Po Dispose zakończeniu połączenia użyj polecenia Control. Metoda Dispose pozostawia Control obiekt w stanie bezużytecznym. Po wywołaniu tej metody należy zwolnić wszystkie odwołania do kontrolki, aby pamięć zajmowana mogła zostać odzyskana przez odzyskiwanie pamięci.

Dotyczy

Produkt	Wersje
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też

Wprowadzenie do cyklu życia strony ASP.NET

Udostępnij za pośrednictwem