Region.Dispose 方法

定義

釋放這個 Region 所使用的所有資源。

C#
public void Dispose ();

實作

範例

下列程式代碼範例示範建 Region 構函式和 ExcludeDispose 方法。

此範例的設計目的是要與 Windows Forms 搭配使用。 將程式代碼貼到表單中,並在處理表單的事件Paint時呼叫 FillRegionExcludingPath 方法,並傳遞ePaintEventArgs

C#
private void FillRegionExcludingPath(PaintEventArgs e)
{

    // Create the region using a rectangle.
    Region myRegion = new Region(new Rectangle(20, 20, 100, 100));

    // Create the GraphicsPath.
    System.Drawing.Drawing2D.GraphicsPath path = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25);

    // Exclude the circle from the region.
    myRegion.Exclude(path);

    // Retrieve a Graphics object from the form.
    Graphics formGraphics = e.Graphics;

    // Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion);

    // Dispose of the path and region objects.
    path.Dispose();
    myRegion.Dispose();
}

備註

呼叫 Dispose 可讓這個 Region 所使用的資源重新配置以供其他用途使用。

Dispose 使用完畢時,請呼叫 RegionDispose 方法會將 Region 保留在無法使用的狀態。 呼叫 Dispose之後,您必須釋放 的所有參考, Region 讓垃圾收集行程可以回收佔用的 Region 記憶體。 如需詳細資訊,請參閱 清除 Unmanaged 資源實作 Dispose 方法

備註

在您釋放最後一個 Dispose 參考之前,請務必呼叫 Region。 否則工作窗格所使用的資源不會釋放,直到記憶體回收行程呼叫 Region 物件的 Finalize 方法。

適用於

產品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9