Pen.Dispose Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.dll

Libera todos los recursos usados por este Pen.

public:
 virtual void Dispose();

public void Dispose();

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

Public Sub Dispose ()

Implementaciones

Dispose()

Ejemplos

En el ejemplo de código siguiente se muestran los efectos de establecer las Width propiedades y LineJoin y se muestra cómo llamar al Dispose método para .Pen

Este ejemplo está diseñado para usarse con Windows Forms. Pegue el código en un formulario y llame al ShowLineJoin método al controlar el evento del Paint formulario, pasando e como 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

Comentarios

La llamada Dispose permite reasignar los recursos usados por este Brush para otros fines.

Llame a Dispose cuando haya terminado de usar .Pen El Dispose método deja en Pen un estado inutilizable. Después de llamar a Dispose, debe liberar todas las referencias a Pen para que el recolector de elementos no utilizados pueda reclamar la memoria que Pen estaba ocupando. Para obtener más información, consulte Limpieza de recursos no administrados e Implementación de un método Dispose.

Note

Dispose Llame siempre antes de liberar la última referencia a .Pen De lo contrario, los recursos que usa no se liberarán hasta que el recolector de elementos no utilizados llame al Pen método del Finalize objeto.