PictureBox.Load Method (String)


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


Type: System.String

The path for the image to display in the PictureBox.

Exception Condition

url is null or an empty string.


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


url refers to a file that is not an image.


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