PictureBox.Load Method (String)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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: