Condividi tramite

BulletedList.BulletImageUrl Proprietà

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 BulletedList controllo .

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 ogni punto elenco in un oggetto BulletedList.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un BulletedList controllo e impostare la BulletImageUrl proprietà per specificare il percorso di un'immagine personalizzata da utilizzare 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 BulletImageUrl proprietà per specificare il percorso di un'immagine da visualizzare come ogni punto elenco in un BulletedList controllo . Per specificare un'immagine personalizzata per i punti elenco, è necessario impostare anche la BulletStyle proprietà sul valore CustomImage.

Annotazioni

Il BulletedList controllo non supporta la AlternateText proprietà perché i proiettili sono intrinsecamente decorativi e non forniscono informazioni aggiuntive che devono essere trasmesse tramite assistive technology. Tuttavia, se vuoi usare un'immagine personalizzata per trasmettere un concetto all'utente, devi aggiungere testo aggiuntivo a ogni elemento elenco puntato 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 al percorso della pagina Web senza specificare un percorso completo nel server. Il percorso è relativo alla posizione della pagina Web. In questo modo è più semplice spostare l'intero sito in un'altra directory nel server senza aggiornare il codice.

L'esempio di codice seguente mostra un percorso relativo a un file di immagine:

\\Images\\image1.jpg

"Images\image1.jpg"

L'esempio di codice seguente mostra 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