System.Web.UI.WebControls.BulletedList.BulletImageUrl Property

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

Syntax

[System.Web.UI.UrlProperty]
[System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.DefaultValue("")]
public virtual string BulletImageUrl { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

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

Note:

The System.Web.UI.WebControls.BulletedList control does not support the Image.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#]

Example

\\Images\\image1.jpg

[Visual Basic]

Example

"Images\image1.jpg"

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

[C#]

Example

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

[Visual Basic]

Example

"c"\MyImagesDir\image1.jpg"

The value of this property is stored in view state.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0