Pen.Dispose Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Pen.cs

Libère toutes les ressources utilisées par ce Pen.

public:
 virtual void Dispose();

public void Dispose ();

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

Public Sub Dispose ()

Implémente

Dispose()

Exemples

L’exemple de code suivant illustre les effets de la Width définition des propriétés et LineJoin et montre comment appeler la Dispose méthode pour un Pen.

Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la ShowLineJoin gestion de l’événement du Paint formulaire, en passant e comme 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

Remarques

L’appel Dispose permet de réallouer les ressources utilisées à Brush d’autres fins.

Appelez la méthode Dispose une fois que vous avez terminé d'utiliser Pen. La méthode Dispose rend le Pen inutilisable. Après avoir appelé Dispose, vous devez libérer toutes les références à afin Pen que le récupérateur de mémoire puisse récupérer la mémoire que le Pen occupait. Pour plus d’informations, consultez Nettoyage des ressources non managées et Implémentation d’une méthode Dispose.

Notes

Appelez toujours Dispose avant de libérer votre dernière référence à Pen. Sinon, les ressources utilisées ne seront pas libérées tant que le garbage collector n'aura pas appelé la méthode Pen de l'objet Finalize.