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"

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

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

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