PictureBox::Load Method (String^)

 

Sets the ImageLocation to the specified URL and displays the image indicated.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
void Load(
	String^ url
)

Parameters

url
Type: System::String^

The path for the image to display in the PictureBox.

Exception Condition
InvalidOperationException

url is null or an empty string.

WebException

url refers to an image on the Web that cannot be accessed.

ArgumentException

url refers to a file that is not an image.

FileNotFoundException

url refers to a file that does not exist.

If the url parameter indicates a local file, the recommended format is a local file path. For example, an image file named myPicture.jpglocated atc:\ would be accessed by passing c:\myPicture.jpg for the url parameter. A full path, such as http://www.contoso.com/path/images/image.jpg, or a relative path, such as ./images/image.jpg, can be used. If a relative path is used, it will be considered relative to the working directory. A call to the Load method sets the ImageLocation property to the value of url.

.NET Framework
Available since 2.0
Return to top
Show: