BulletedList.BulletImageUrl Proprietà

Definizione

Ottiene o imposta il percorso di un'immagine da visualizzare per ogni punto elenco in un controllo BulletedList.Gets or sets the path to an image to display for each bullet in a BulletedList control.

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.The path to an image to display as each bullet in a BulletedList.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un controllo BulletedList e impostare la proprietà BulletImageUrl per specificare il percorso di un'immagine personalizzata da utilizzare per ogni punto elenco.The following code example demonstrates how to create a BulletedList control and set the BulletImageUrl property to specify the path to a custom image to use for each bullet.

<%@ 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à BulletImageUrl per specificare il percorso di un'immagine da visualizzare come ogni punto elenco in un controllo BulletedList.Use the BulletImageUrl property to specify the path to an image to display as each bullet in a BulletedList control. Per specificare un'immagine personalizzata per i punti elenco, è necessario impostare anche la proprietà BulletStyle sul valore CustomImage.To specify a custom image for the bullets, you must also set the BulletStyle property to the value CustomImage.

Nota

Il controllo BulletedList non supporta la proprietà AlternateText perché i punti elenco sono intrinsecamente decorativi e non forniscono informazioni aggiuntive che devono essere trasmesse attraverso la tecnologia per l'accesso facilitato.The BulletedList control does not support the AlternateText property because the bullets are inherently decorative and do not provide additional information that needs to be conveyed via assistive technology. Tuttavia, se si desidera utilizzare un'immagine personalizzata per fornire un concetto all'utente, è necessario aggiungere altro testo a ogni elemento dell'elenco puntato o utilizzare un controllo che consenta di specificare testo alternativo per ogni immagine.However, if you want to use a custom image to convey a concept to the user, you should add additional text to each of the bulleted list items or use a control that allows you to specify alternate text for each image.

È possibile specificare un percorso relativo o assoluto per l'immagine.You can specify either a relative or an absolute path to the image. Un percorso relativo mette in correlazione il percorso dell'immagine al percorso della pagina Web senza specificare un percorso completo sul server.A relative path relates the location of the image to the location of the Web page without specifying a complete path on the server. Il percorso è relativo alla posizione della pagina Web.The path is relative to the location of the Web page. In questo modo è più semplice spostare l'intero sito in un'altra directory del server senza aggiornare il codice.This makes it easier to move the entire site to another directory on the server without updating the code.

Nell'esempio di codice seguente viene illustrato un percorso relativo di un file di immagine:The following code example shows a relative path to an image file:

\\Images\\image1.jpg
"Images\image1.jpg"

Nell'esempio di codice seguente viene illustrato un percorso assoluto di un file di immagine:The following code example shows an absolute path to an image file:

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

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Si applica a

Vedi anche