IsDisposed Property

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public bool IsDisposed {get;}

'Declaration
 
Public ReadOnly Property IsDisposed As Boolean

'Usage
 
Dim instance As RasterImage
Dim value As Boolean
 
value = instance.IsDisposed

public bool IsDisposed {get;}

 get_IsDisposed();

public:
property bool IsDisposed {
   bool get();
}

Property Value

true if the RasterImage object has been disposed of; false, otherwise.

When this property returns true, the RasterImage object is disposed of and can no longer be referenced as a valid object. Even though the instance of an object is disposed of, it is still maintained in memory until it is removed from memory through garbage collection. When an object is disposed, you should not check any other properties or call any other methods in the control or an System.NullReferenceException error will occur.

If it is required to track when a RasterImage object is disposed, use the Disposed event.

The RasterImage class implements the System.IDisposable interface, it is recommended that you follow the standard .NET dispose pattern when using the RasterImage class. For more information, refer to the System.IDisposable interface documentation in MSDN.

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Public Sub IsDisposedTest()
   ' Create a RasterImage objects
   Dim image As New RasterImage( _
      RasterMemoryFlags.Conventional, _
      100, _
      100, _
      24, _
      RasterByteOrder.Bgr, _
      RasterViewPerspective.TopLeft, _
      Nothing, _
      IntPtr.Zero, _
      0)
   ' Check the IsDisposed property, should be false
   Debug.Assert(Not image.IsDisposed)
   MessageBox.Show("IsDisposed = " + image.IsDisposed.ToString())

   ' Now dispose the image
   image.Dispose()

   ' Re-check the IsDisposed property, should be true
   Debug.Assert(image.IsDisposed)
   MessageBox.Show("IsDisposed = " + image.IsDisposed.ToString())
End Sub

public void IsDisposedTest()
{
   // Create a RasterImage objects
   RasterImage image = new RasterImage(
      RasterMemoryFlags.Conventional,
      100,
      100,
      24,
      RasterByteOrder.Bgr,
      RasterViewPerspective.TopLeft,
      null,
      IntPtr.Zero,
      0);

   // Check the IsDisposed property, should be false
   Debug.Assert(!image.IsDisposed);
   MessageBox.Show("IsDisposed = " + image.IsDisposed.ToString());

   // Now dispose the image
   image.Dispose();

   // Re-check the IsDisposed property, should be true
   Debug.Assert(image.IsDisposed);
   MessageBox.Show("IsDisposed = " + image.IsDisposed.ToString());
}

public void IsDisposedTest()
{
   // Create a RasterImage objects
   RasterImage image = new RasterImage(
      RasterMemoryFlags.Conventional,
      100,
      100,
      24,
      RasterByteOrder.Bgr,
      RasterViewPerspective.TopLeft,
      null,
      null,
      0);
   // Check the IsDisposed property, should be false
   Debug.Assert(!image.IsDisposed);
   Debug.WriteLine("IsDisposed = " + image.IsDisposed.ToString());

   // Now dispose the image
   image.Dispose();

   // Re-check the IsDisposed property, should be true
   Debug.Assert(image.IsDisposed);
   Debug.WriteLine("IsDisposed = " + image.IsDisposed.ToString());
}

Public Sub IsDisposedTest()
   ' Create a RasterImage objects
   Dim image As RasterImage = New RasterImage(RasterMemoryFlags.Conventional, 100, 100, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, Nothing, Nothing, 0)
   ' Check the IsDisposed property, should be false
   Debug.Assert((Not image.IsDisposed))
   Debug.WriteLine("IsDisposed = " & image.IsDisposed.ToString())

   ' Now dispose the image
   image.Dispose()

   ' Re-check the IsDisposed property, should be true
   Debug.Assert(image.IsDisposed)
   Debug.WriteLine("IsDisposed = " & image.IsDisposed.ToString())
End Sub

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

RasterImage Class
RasterImage Members