BulletedList.BulletImageUrl Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o caminho para uma imagem a mostrar para cada bala num BulletedList controlo.

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 de Propriedade

String

O caminho para uma imagem a mostrar como cada bala num BulletedList.

Exemplos

O exemplo de código seguinte demonstra como criar um BulletedList controlo e definir a BulletImageUrl propriedade para especificar o caminho para uma imagem personalizada a usar para cada ponto de partida.

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

Observações

Use a BulletImageUrl propriedade para especificar o caminho para uma imagem a ser exibido como cada bala num BulletedList controlo. Para especificar uma imagem personalizada para os marcadores, deve também definir a BulletStyle propriedade para o valor CustomImage.

Note

O BulletedList controlo não suporta a AlternateText propriedade porque as balas são inerentemente decorativas e não fornecem informação adicional que precise de ser transmitida através de tecnologia assistiva. No entanto, se quiser usar uma imagem personalizada para transmitir um conceito ao utilizador, deve adicionar texto adicional a cada item da lista com marcadores ou usar um controlo que permita especificar texto alternativo para cada imagem.

Pode especificar um caminho relativo ou absoluto até à imagem. Um caminho relativo relaciona a localização da imagem com a localização da página Web sem especificar um caminho completo no servidor. O percurso é relativo à localização da página Web. Isto facilita mover todo o site para outro diretório no servidor sem atualizar o código.

O seguinte exemplo de código mostra um caminho relativo até um ficheiro de imagem:

\\Images\\image1.jpg

"Images\image1.jpg"

O seguinte exemplo de código mostra um caminho absoluto para um ficheiro de imagem:

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

"c"\MyImagesDir\image1.jpg"

O valor desta propriedade é armazenado no estado de visualização.

Aplica-se a

Ver também