Język

Pen.Dispose Metoda

Definicja

Zwalnia wszystkie zasoby używane przez ten Penprogram .

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

Implementuje

Przykłady

W poniższym przykładzie kodu pokazano efekty ustawiania Width właściwości i LineJoin oraz pokazano, jak wywołać Dispose metodę dla elementu Pen.

Ten przykład został zaprojektowany do użycia z formularzami systemu Windows. Wklej kod do formularza i wywołaj ShowLineJoin metodę podczas obsługi zdarzenia formularza Paint , przekazując e jako 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 umożliwia przeniesienie zasobów używanych przez tę Brush funkcję do innych celów.

Wywołaj metodę Dispose po zakończeniu korzystania z elementu Pen. Metoda Dispose pozostawia Pen w stanie bezużytecznym. Po wywołaniu metody Disposenależy zwolnić wszystkie odwołania do Pen modułu , aby moduł odśmiecania pamięci mógł odzyskać pamięć zajmowaną przez Pen element . Aby uzyskać więcej informacji, zobacz Oczyszczanie zasobów niezarządzanych i Implementowanie metody Dispose.

Note

Przed wydaniem ostatniego odwołania do elementu należy zawsze wywołać metodę DisposePen. W przeciwnym razie zasoby, których używasz, nie zostaną zwolnione, dopóki moduł odśmiecający elementy bezużyteczne wywoła Pen metodę obiektu Finalize .

Dotyczy