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


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"

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

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

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