Pen.Dispose Metoda

Definicja

Zwalnia wszystkie zasoby używane przez ten program Pen .Releases all resources used by this Pen.

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

Implementuje

Przykłady

Poniższy przykład kodu demonstruje efekty ustawiania Width LineJoin właściwości i i pokazuje sposób wywoływania Dispose metody dla Pen .The following code example demonstrates the effects of setting the Width and LineJoin properties, and shows how to call the Dispose method for a Pen.

Ten przykład jest przeznaczony do użycia z Windows Forms.This example is designed to be used with Windows Forms. Wklej kod do formularza i Wywołaj ShowLineJoin metodę podczas obsługi Paint zdarzenia formularza, przekazując e jako PaintEventArgs .Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }
private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}
Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

Uwagi

Wywołanie Dispose zezwala na przydzielenie zasobów używanych przez ten program Brush do innych celów.Calling Dispose allows the resources used by this Brush to be reallocated for other purposes.

Wywołaj Dispose po zakończeniu korzystania z Pen .Call Dispose when you are finished using the Pen. DisposeMetoda pozostawia Pen w stanie niezdatnym do użytku.The Dispose method leaves the Pen in an unusable state. Po wywołaniu Dispose należy wydać wszystkie odwołania do, Pen Aby moduł wyrzucania elementów bezużytecznych mógł odwoływać pamięć, którą Pen zajmował.After calling Dispose, you must release all references to the Pen so the garbage collector can reclaim the memory that the Pen was occupying. Aby uzyskać więcej informacji, zobacz Oczyszczanie zasobów niezarządzanych i implementowanie metody Dispose.For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

Uwaga

Zawsze wywołuj Dispose przed wydaniem ostatniego odwołania do Pen .Always call Dispose before you release your last reference to the Pen. W przeciwnym razie używane zasoby nie zostaną zwolnione do momentu wywołania metody obiektu przez moduł zbierający elementy bezużyteczne Pen Finalize .Otherwise, the resources it is using will not be freed until the garbage collector calls the Pen object's Finalize method.

Dotyczy