Pen.Dispose Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

Pen.cs

Merilis semua sumber daya yang digunakan oleh ini Pen.

public:
 virtual void Dispose();

public void Dispose ();

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

Public Sub Dispose ()

Penerapan

Dispose()

Contoh

Contoh kode berikut menunjukkan efek pengaturan Width properti dan LineJoin , dan menunjukkan cara memanggil Dispose metode untuk Pen.

Contoh ini dirancang untuk digunakan dengan Formulir Windows. Tempelkan kode ke dalam formulir dan panggil ShowLineJoin metode saat menangani peristiwa formulir Paint , meneruskan e sebagai 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

Keterangan

Dispose Panggilan memungkinkan sumber daya yang digunakan oleh ini Brush untuk dialihkan untuk tujuan lain.

Panggil Dispose ketika Anda selesai menggunakan Pen. Metode Dispose ini meninggalkan Pen dalam keadaan tidak dapat digunakan. Setelah memanggil Dispose, Anda harus merilis semua referensi ke Pen sehingga pengumpul sampah dapat mengklaim kembali memori yang Pen diduduki. Untuk informasi selengkapnya, lihat Membersihkan Sumber Daya yang Tidak Dikelola dan Menerapkan Metode Buang.

Catatan

Selalu panggil Dispose sebelum Anda merilis referensi terakhir Anda ke Pen. Jika tidak, sumber daya yang digunakannya tidak akan dikosongkan Pen sampai pengumpul sampah memanggil metode objek Finalize .