Sdílet prostřednictvím

BulletedList.BulletImageUrl Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví cestu k obrázku, který se zobrazí pro každou odrážku v ovládacím BulletedList prvku.

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

Hodnota vlastnosti

String

Cesta k obrázku, která se má zobrazit jako každá odrážka v objektu BulletedList.

Příklady

Následující příklad kódu ukazuje, jak vytvořit BulletedList ovládací prvek a nastavit BulletImageUrl vlastnost zadat cestu k vlastní image, která se má použít pro každou odrážku.

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

Poznámky

BulletImageUrl Pomocí vlastnosti určete cestu k obrázku, která se má zobrazit jako každá odrážka v ovládacím BulletedList prvku. Chcete-li zadat vlastní obrázek pro odrážky, musíte také nastavit BulletStyle vlastnost na hodnotu CustomImage.

Poznámka:

Ovládací BulletedList prvek nepodporuje AlternateText vlastnost, protože odrážky jsou ze své podstaty dekorativní a neposkytují další informace, které je třeba sdělit prostřednictvím technologie usnadnění. Pokud ale chcete k vyjádření konceptu uživateli použít vlastní obrázek, měli byste do každé položky seznamu s odrážkami přidat další text nebo použít ovládací prvek, který umožňuje zadat alternativní text pro každý obrázek.

Můžete zadat relativní nebo absolutní cestu k obrázku. Relativní cesta souvisí umístění obrázku s umístěním webové stránky bez zadání úplné cesty na serveru. Cesta je relativní vzhledem k umístění webové stránky. To usnadňuje přesun celého webu do jiného adresáře na serveru bez aktualizace kódu.

Následující příklad kódu ukazuje relativní cestu k souboru obrázku:

\\Images\\image1.jpg

"Images\image1.jpg"

Následující příklad kódu ukazuje absolutní cestu k souboru obrázku:

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

"c"\MyImagesDir\image1.jpg"

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Platí pro

Viz také