Pen.Dispose Metoda

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Pen.cs

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

Dispose()

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ę Pendla klasy .

Ten przykład jest przeznaczony do użycia z Windows Forms. Wklej kod do formularza i wywołaj ShowLineJoin metodę podczas obsługi zdarzenia formularza Paint , przekazując e go 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 przydział zasobów używanych przez tę Brush funkcję do innych celów.

Po Dispose zakończeniu połączenia użyj polecenia Pen. Metoda Dispose pozostawia Pen obiekt w stanie bezużytecznym. Po wywołaniu Disposemetody należy zwolnić wszystkie odwołania do Pen modułu , aby moduł odśmiecania pamięci mógł odzyskać pamięć zajmowaną przez Pen moduł. Aby uzyskać więcej informacji, zobacz Oczyszczanie niezarządzanych zasobów i Implementowanie metody Dispose.

Uwaga

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 do momentu wywołania Pen metody obiektu przez moduł odśmiecowania Finalize pamięci.