The unique image identifier of the image resource to be released.
Example





In This Topic

DisposeImage Method (GdPictureDocumentUtilities)

In This Topic
Releases a specified image and its corresponding image resource from memory. This method is particularly useful if you work with images outside the GdPictureImaging class, for example if you are using the GdPicturePDF class.Best Practices
Best Practices
Syntax
'Declaration

 

Public Shared Function DisposeImage( _

   ByVal ImageID As Integer _

) As GdPictureStatus
public static GdPictureStatus DisposeImage( 

   int ImageID

)
public function DisposeImage( 

    ImageID: Integer

): GdPictureStatus; static; 
public static function DisposeImage( 

   ImageID : int

) : GdPictureStatus;
public: static GdPictureStatus DisposeImage( 

   int ImageID

) 
public:

static GdPictureStatus DisposeImage( 

   int ImageID

) 

Parameters

ImageID
The unique image identifier of the image resource to be released.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.
Remarks
It is always a best practice to release images you have created once you have no use for them. You can find some our recommendations in this Best Practices tutorial.Best Practices
Example
How to dispose of the used image.
Best Practices
Dim gdpicturePDF As GdPicturePDF = New GdPicturePDF()

If gdpicturePDF.LoadFromFile("test.pdf", False) = GdPictureStatus.OK Then

    Dim pageCount As Integer = gdpicturePDF.GetPageCount()

    Dim status As GdPictureStatus = gdpicturePDF.GetStat()

    If (status = GdPictureStatus.OK) AndAlso (pageCount > 0) Then

        Dim imageCount As Integer = gdpicturePDF.GetPageImageCount()

        status = gdpicturePDF.GetStat()

        If (status = GdPictureStatus.OK) AndAlso (imageCount > 0) Then

            Dim imageID As Integer = 0

            For i As Integer = 1 To imageCount

                imageID = gdpicturePDF.ExtractPageImage(i)

                status = gdpicturePDF.GetStat()

                If status = GdPictureStatus.OK Then

                    'Do your stuff with the extracted image here.

                    ' ...

                    'Dispose of the image after you have used it.

                    If GdPictureDocumentUtilities.DisposeImage(imageID) <> GdPictureStatus.OK Then

                        MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture")

                    End If

                End If

            Next

        Else

            If status = GdPictureStatus.OK Then

                MessageBox.Show("The first page doesn't contain any image.", "GdPicture")

            Else

                MessageBox.Show("Error: " + status.ToString(), "GdPicture")

            End If

        End If

    Else

        If status = GdPictureStatus.OK Then

            MessageBox.Show("This file doesn't contain any page.", "GdPicture")

        Else

            MessageBox.Show("Error: " + status.ToString(), "GdPicture")

        End If

    End If

Else

    MessageBox.Show("The file can't be loaded.", "GdPicture")

End If

gdpicturePDF.Dispose()
GdPicturePDF gdpicturePDF = new GdPicturePDF();

if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK)

{

    int pageCount = gdpicturePDF.GetPageCount();

    GdPictureStatus status = gdpicturePDF.GetStat();

    if ((status == GdPictureStatus.OK) && (pageCount > 0))

    {

        int imageCount = gdpicturePDF.GetPageImageCount();

        status = gdpicturePDF.GetStat();

        if ((status == GdPictureStatus.OK) && (imageCount > 0))

        {

            int imageID = 0;

            for (int i = 1; i <= imageCount; i++)

            {

                imageID = gdpicturePDF.ExtractPageImage(i);

                status = gdpicturePDF.GetStat();

                if (status == GdPictureStatus.OK)

                {

                    //Do your stuff with the extracted image here.

                    //...

                    //Dispose of the image after you have used it.

                    if (GdPictureDocumentUtilities.DisposeImage(imageID) != GdPictureStatus.OK)

                        MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture");

                }

            }

        }

        else

        {

            if (status == GdPictureStatus.OK)

                MessageBox.Show("The first page doesn't contain any image.", "GdPicture");

            else

                MessageBox.Show("Error: " + status.ToString(), "GdPicture");

        }

    }

    else

    {

        if (status == GdPictureStatus.OK)

            MessageBox.Show("This file doesn't contain any page.", "GdPicture");

        else

            MessageBox.Show("Error: " + status.ToString(), "GdPicture");

    }

}

else

    MessageBox.Show("The file can't be loaded.", "GdPicture");

gdpicturePDF.Dispose();
Example
Best Practices
How to dispose of the used image. Dim gdpicturePDF As GdPicturePDF = New GdPicturePDF() If gdpicturePDF.LoadFromFile("test.pdf", False) = GdPictureStatus.OK Then Dim pageCount As Integer = gdpicturePDF.GetPageCount() Dim status As GdPictureStatus = gdpicturePDF.GetStat() If (status = GdPictureStatus.OK) AndAlso (pageCount > 0) Then Dim imageCount As Integer = gdpicturePDF.GetPageImageCount() status = gdpicturePDF.GetStat() If (status = GdPictureStatus.OK) AndAlso (imageCount > 0) Then Dim imageID As Integer = 0 For i As Integer = 1 To imageCount imageID = gdpicturePDF.ExtractPageImage(i) status = gdpicturePDF.GetStat() If status = GdPictureStatus.OK Then 'Do your stuff with the extracted image here. ' ... 'Dispose of the image after you have used it. If GdPictureDocumentUtilities.DisposeImage(imageID) <> GdPictureStatus.OK Then MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture") End If End If Next Else If status = GdPictureStatus.OK Then MessageBox.Show("The first page doesn't contain any image.", "GdPicture") Else MessageBox.Show("Error: " + status.ToString(), "GdPicture") End If End If Else If status = GdPictureStatus.OK Then MessageBox.Show("This file doesn't contain any page.", "GdPicture") Else MessageBox.Show("Error: " + status.ToString(), "GdPicture") End If End If Else MessageBox.Show("The file can't be loaded.", "GdPicture") End If gdpicturePDF.Dispose() GdPicturePDF gdpicturePDF = new GdPicturePDF(); if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK) { int pageCount = gdpicturePDF.GetPageCount(); GdPictureStatus status = gdpicturePDF.GetStat(); if ((status == GdPictureStatus.OK) && (pageCount > 0)) { int imageCount = gdpicturePDF.GetPageImageCount(); status = gdpicturePDF.GetStat(); if ((status == GdPictureStatus.OK) && (imageCount > 0)) { int imageID = 0; for (int i = 1; i <= imageCount; i++) { imageID = gdpicturePDF.ExtractPageImage(i); status = gdpicturePDF.GetStat(); if (status == GdPictureStatus.OK) { //Do your stuff with the extracted image here. //... //Dispose of the image after you have used it. if (GdPictureDocumentUtilities.DisposeImage(imageID) != GdPictureStatus.OK) MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture"); } } } else { if (status == GdPictureStatus.OK) MessageBox.Show("The first page doesn't contain any image.", "GdPicture"); else MessageBox.Show("Error: " + status.ToString(), "GdPicture"); } } else { if (status == GdPictureStatus.OK) MessageBox.Show("This file doesn't contain any page.", "GdPicture"); else MessageBox.Show("Error: " + status.ToString(), "GdPicture"); } } else MessageBox.Show("The file can't be loaded.", "GdPicture"); gdpicturePDF.Dispose();
See Also