BulletedList.BulletImageUrl Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit le chemin d'accès à une image à afficher pour chaque puce dans un contrôle 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

Valeur de propriété

String

Chemin d'accès vers une image à afficher pour chaque puce dans un BulletedList.

Exemples

L’exemple de code suivant montre comment créer un BulletedList contrôle et définir la BulletImageUrl propriété pour spécifier le chemin d’accès à une image personnalisée à utiliser pour chaque puce.

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

Remarques

Utilisez la BulletImageUrl propriété pour spécifier le chemin d’accès à une image à afficher comme chaque puce d’un BulletedList contrôle. Pour spécifier une image personnalisée pour les puces, vous devez également définir la BulletStyle propriété sur la valeur CustomImage.

Notes

Le BulletedList contrôle ne prend pas en charge la AlternateText propriété, car les puces sont intrinsèquement décoratives et ne fournissent pas d’informations supplémentaires qui doivent être transmises via la technologie d’assistance. Toutefois, si vous souhaitez utiliser une image personnalisée pour transmettre un concept à l’utilisateur, vous devez ajouter du texte supplémentaire à chacun des éléments de liste à puces ou utiliser un contrôle qui vous permet de spécifier du texte de remplacement pour chaque image.

Vous pouvez spécifier un chemin d’accès relatif ou absolu à l’image. Un chemin relatif associe l’emplacement de l’image à l’emplacement de la page Web sans spécifier de chemin d’accès complet sur le serveur. Le chemin d’accès est relatif à l’emplacement de la page Web. Cela facilite le déplacement de l’ensemble du site vers un autre répertoire sur le serveur sans mettre à jour le code.

L’exemple de code suivant montre un chemin d’accès relatif à un fichier image :

\\Images\\image1.jpg

"Images\image1.jpg"

L’exemple de code suivant montre un chemin absolu d’accès à un fichier image :

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

"c"\MyImagesDir\image1.jpg"

La valeur de cette propriété est stockée dans l’état d’affichage.

S’applique à

Voir aussi