Bitmap Constructor (Stream^)

 

Initializes a new instance of the Bitmap class from the specified data stream.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
Bitmap(
	Stream^ stream
)

Parameters

stream
Type: System.IO::Stream^

The data stream used to load the image.

Exception Condition
System::ArgumentException

stream does not contain image data or is null.

-or-

stream contains a PNG image file with a single dimension greater than 65,535 pixels.

You must keep the stream open for the lifetime of the Bitmap.

Due to a limitation of the GDI+ decoder, an System::ArgumentException is thrown if you construct a bitmap from a .png image file with a single dimension greater than 65,535 pixels.

The following code example demonstrates how to load a bitmap from a stream.

This example is designed to be used with Windows Forms. Create a form that contains a PictureBox named PictureBox1. Paste the code into the form and call the InitializeStreamBitmap method from the form's constructor or Load event-handling method.

void InitializeStreamBitmap()
{
   try
   {
      System::Net::WebRequest^ request = System::Net::WebRequest::Create( "http://www.microsoft.com//h/en-us/r/ms_masthead_ltr.gif" );
      System::Net::WebResponse^ response = request->GetResponse();
      System::IO::Stream^ responseStream = response->GetResponseStream();
      Bitmap^ bitmap2 = gcnew Bitmap( responseStream );
      PictureBox1->Image = bitmap2;
   }
   catch ( System::Net::WebException^ ) 
   {
      MessageBox::Show( "There was an error opening the image file."
      "Check the URL" );
   }

}

.NET Framework
Available since 1.1
Return to top
Show: