Control.Dispose Metoda

Definicja

Umożliwia formantowi serwera przeprowadzenie końcowego oczyszczania przed jego zwolnieniem z pamięci.Enables a server control to perform final clean up before it is released from memory.

public:
 virtual void Dispose();
public virtual void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Overridable Sub Dispose ()

Implementuje

Przykłady

Poniższy przykład kodu zastępuje metodę Dispose, aby zamknąć obiekt HtmlTextWriter skojarzony z kontrolką i wywołać metodę Dispose na kontrolce Button o nazwie myButton.The following code example overrides the Dispose method to close the HtmlTextWriter object associated with a control, and call the Dispose method on a Button control, named myButton. Jeśli zostanie wygenerowane Exception, gdy zostanie wywołana ta wersja metody Dispose, formant zapisuje komunikat do bieżącego obiektu HttpResponse.If an Exception is thrown when this version of the Dispose method is called, the control writes a message to the current HttpResponse object.

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

Wywołaj Dispose po zakończeniu korzystania z Control.Call Dispose when you are finished using the Control. Metoda Dispose pozostawia Control w stanie niezdatnym do użytku.The Dispose method leaves the Control in an unusable state. Po wywołaniu tej metody należy wydać wszystkie odwołania do kontrolki, aby pamięć, która zajmowała się, mogła zostać odbrana przez wyrzucanie elementów bezużytecznych.After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.

Dotyczy

Zobacz też