Pen.Dispose Método

Definición

Libera todos los recursos utilizados por este 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 ()

Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestran los efectos de establecer las Width LineJoin propiedades y, y se muestra cómo llamar al Dispose método para 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.

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

Comentarios

La llamada a Dispose permite reasignar los recursos utilizados por este Brush para otros fines.Calling Dispose allows the resources used by this Brush to be reallocated for other purposes.

Llame a Dispose cuando haya terminado de usar Pen.Call Dispose when you are finished using the Pen. El método Dispose deja el Pen en un estado no utilizable.The Dispose method leaves the Pen in an unusable state. Después de llamar a Dispose , debe liberar todas las referencias a para Pen que el recolector de elementos no utilizados pueda reclamar la memoria que Pen ocupaba.After calling Dispose, you must release all references to the Pen so the garbage collector can reclaim the memory that the Pen was occupying. Para obtener más información, vea limpiar recursos no administrados e implementar un método Dispose.For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

Nota

Realice siempre una llamada a Dispose antes de liberar la última referencia al objeto Pen.Always call Dispose before you release your last reference to the Pen. En caso contrario, los recursos que está usando no se liberarán hasta que el recolector de elementos no utilizados llame al método Pen del objeto Finalize.Otherwise, the resources it is using will not be freed until the garbage collector calls the Pen object's Finalize method.

Se aplica a