Bitmap Constructor (Stream^)
Initializes a new instance of the Bitmap class from the specified data stream.
Assembly: System.Drawing (in System.Drawing.dll)
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" ); } }
Available since 1.1