BulletedList.BulletImageUrl Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает путь к изображению для каждого маркера, отображаемого в элементе управления BulletedList.
public:
virtual property System::String ^ BulletImageUrl { System::String ^ get(); void set(System::String ^ value); };
public virtual string BulletImageUrl { get; set; }
member this.BulletImageUrl : string with get, set
Public Overridable Property BulletImageUrl As String
Значение свойства
Путь к изображению, которое следует использовать как маркер в BulletedList.
Примеры
В следующем примере кода показано, как создать BulletedList элемент управления и задать BulletImageUrl свойство , чтобы указать путь к пользовательскому образу, который будет использоваться для каждого маркера.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>BulletImageUrl Example</title>
</head>
<body>
<h3>BulletImageUrl Example</h3>
<form id="form1" runat="server">
<asp:BulletedList id="ItemsBulletedList"
DisplayMode="Text"
BulletStyle="CustomImage"
BulletImageUrl="Images/image1.jpg"
runat="server">
<asp:ListItem Value="0">Coho Winery</asp:ListItem>
<asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>BulletImageUrl Example</title>
</head>
<body>
<h3>BulletImageUrl Example</h3>
<form id="form1" runat="server">
<asp:BulletedList id="ItemsBulletedList"
DisplayMode="Text"
BulletStyle="CustomImage"
BulletImageUrl="Images/image1.jpg"
runat="server">
<asp:ListItem Value="0">Coho Winery</asp:ListItem>
<asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
</form>
</body>
</html>
Комментарии
Используйте свойство , BulletImageUrl чтобы указать путь к изображению, которое будет отображаться в качестве каждого маркера в элементе BulletedList управления . Чтобы указать пользовательский образ для маркеров, необходимо также присвоить свойству BulletStyle значение CustomImage.
Примечание
Элемент BulletedList управления не поддерживает свойство , AlternateText так как маркеры по своей сути являются декоративными и не предоставляют дополнительную информацию, которую необходимо передать с помощью специальных возможностей. Однако если вы хотите использовать пользовательское изображение для передачи концепции пользователю, следует добавить дополнительный текст к каждому элементу маркированного списка или использовать элемент управления, позволяющий указать альтернативный текст для каждого изображения.
Можно указать относительный или абсолютный путь к изображению. Относительный путь связывает расположение изображения с расположением веб-страницы без указания полного пути на сервере. Путь относится к расположению веб-страницы. Это упрощает перемещение всего сайта в другой каталог на сервере без обновления кода.
В следующем примере кода показан относительный путь к файлу изображения:
\\Images\\image1.jpg
"Images\image1.jpg"
В следующем примере кода показан абсолютный путь к файлу изображения:
"c:\\MyImagesDir\\image1.jpg"
"c"\MyImagesDir\image1.jpg"
Значение этого свойства хранится в состоянии представления.