BulletedList.BulletImageUrl Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define o caminho para uma imagem a ser exibido para cada marcador em um controle 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

Valor da propriedade

String

O caminho para uma imagem a ser exibido como um marcador individual em um BulletedList.

Exemplos

O exemplo de código a seguir demonstra como criar um BulletedList controle e definir a BulletImageUrl propriedade para especificar o caminho para uma imagem personalizada a ser usada para cada marcador.

<%@ 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>

Comentários

Use a BulletImageUrl propriedade para especificar o caminho para uma imagem a ser exibida como cada marcador em um BulletedList controle. Para especificar uma imagem personalizada para os marcadores, você também deve definir a BulletStyle propriedade como o valor CustomImage.

Observação

O BulletedList controle não dá suporte à AlternateText propriedade porque os marcadores são inerentemente decorativos e não fornecem informações adicionais que precisam ser transmitidas por meio da tecnologia adaptativa. No entanto, se você quiser usar uma imagem personalizada para transmitir um conceito ao usuário, deverá adicionar texto adicional a cada um dos itens da lista com marcadores ou usar um controle que permita especificar texto alternativo para cada imagem.

Você pode especificar um caminho relativo ou absoluto para a imagem. Um caminho relativo relaciona o local da imagem ao local da página da Web sem especificar um caminho completo no servidor. O caminho é relativo ao local da página da Web. Isso facilita a movimentação de todo o site para outro diretório no servidor sem atualizar o código.

O exemplo de código a seguir mostra um caminho relativo para um arquivo de imagem:

\\Images\\image1.jpg

"Images\image1.jpg"

O exemplo de código a seguir mostra um caminho absoluto para um arquivo de imagem:

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

"c"\MyImagesDir\image1.jpg"

O valor dessa propriedade é armazenado no estado de exibição.

Aplica-se a

Confira também