This documentation is archived and is not being maintained.

BulletedList::BulletImageUrl Property

Gets or sets the path to an image to display for each bullet in a BulletedList control.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public:
virtual property String^ BulletImageUrl {
	String^ get ();
	void set (String^ value);
}
<asp:BulletedList BulletImageUrl="String" />

Property Value

Type: System::String
The path to an image to display as each bullet in a BulletedList.

Use the BulletImageUrl property to specify the path to an image to display as each bullet in a BulletedList control. To specify a custom image for the bullets, you must also set the BulletStyle property to the value CustomImage.

NoteNote

The BulletedList control does not support the AlternateText property because the bullets are inherently decorative and do not provide additional information that needs to be conveyed via assistive technology. However, if you want to use a custom image to convey a concept to the user, you should add additional text to each of the bulleted list items or use a control that allows you to specify alternate text for each image.

You can specify either a relative or an absolute path to the image. A relative path relates the location of the image to the location of the Web page without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the code.

The following code example shows a relative path to an image file:

[C#]

\\Images\\image1.jpg

[Visual Basic]

"Images\image1.jpg"

The following code example shows an absolute path to an image file:

[C#]

"c:\\MyImagesDir\\image1.jpg" 

[Visual Basic]

"c"\MyImagesDir\image1.jpg"

The value of this property is stored in view state.

The following code example demonstrates how to create a BulletedList control and set the BulletImageUrl property to specify the path to a custom image to use for each bullet.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: