Поделиться через

BulletedList.BulletImageUrl Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает путь к изображению, отображаемого для каждого маркера в элементе 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

Значение свойства

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"

Значение этого свойства хранится в состоянии представления.

Применяется к

См. также раздел