BulletedList.BulletImageUrl Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta il percorso di un'immagine da visualizzare per ogni punto elenco in un controllo 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

Valore della proprietà

String

Percorso di un'immagine da visualizzare come punto elenco in un oggetto BulletedList.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un BulletedList controllo e impostare la proprietà per specificare il BulletImageUrl percorso di un'immagine personalizzata da usare per ogni punto elenco.

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

Commenti

Utilizzare la proprietà per specificare il BulletImageUrl percorso di un'immagine da visualizzare come ogni punto puntato in un BulletedList controllo. Per specificare un'immagine personalizzata per gli elenchi puntati, è necessario impostare anche la proprietà sul BulletStyle valore CustomImage.

Nota

Il BulletedList controllo non supporta la AlternateText proprietà perché i proiettili sono intrinsecamente decorativi e non forniscono informazioni aggiuntive che devono essere trasmesse tramite la tecnologia assistive. Tuttavia, se si vuole usare un'immagine personalizzata per trasmettere un concetto all'utente, è necessario aggiungere testo aggiuntivo a ognuno degli elementi elenco puntati o usare un controllo che consente di specificare testo alternativo per ogni immagine.

È possibile specificare un percorso relativo o assoluto dell'immagine. Un percorso relativo collega la posizione dell'immagine alla posizione della pagina Web senza specificare un percorso completo nel server. Il percorso è relativo alla posizione della pagina Web. Ciò semplifica lo spostamento dell'intero sito in un'altra directory nel server senza aggiornare il codice.

Nell'esempio di codice seguente viene illustrato un percorso relativo a un file di immagine:

\\Images\\image1.jpg

"Images\image1.jpg"

Nell'esempio di codice seguente viene illustrato un percorso assoluto di un file di immagine:

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

"c"\MyImagesDir\image1.jpg"

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a

Vedi anche