Pen.Dispose 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

Pen.cs

释放此 Pen 使用的所有资源。

public:
 virtual void Dispose();

public void Dispose ();

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

Public Sub Dispose ()

实现

Dispose()

示例

下面的代码示例演示设置 Width 和 LineJoin 属性的效果，并演示如何 Dispose 调用 的 Pen方法。

此示例旨在与 Windows 窗体 一起使用。 将代码粘贴到窗体中，并在处理窗体的 Paint 事件时调用 ShowLineJoin 方法，作为 ePaintEventArgs传递。

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

注解

调用 Dispose 允许重新分配用于 Brush 其他目的的资源。

在完成使用 Dispose 后，应调用 Pen。 Dispose 方法使 Pen 处于不可用状态。 调用 Dispose后，必须释放对 Pen 的所有引用，以便垃圾回收器可以回收 占用的内存 Pen 。 有关详细信息，请参阅清理非托管资源和实现 Dispose 方法。

注意

每次释放对 Dispose 的最后一个引用前，均应调用 Pen。 否则，在垃圾回收器调用 Pen 对象的 Finalize 方法之前，该对象正在使用的资源不会被释放。