BulletedList.BulletImageUrl Vlastnost

  • Reference

Definice

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

Získá nebo nastaví cestu k obrázku k zobrazení 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 zobrazí 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 k určení cesty k vlastnímu obrázku, 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

Vlastnost slouží BulletImageUrl k určení cesty k obrázku, který se má zobrazit jako každá odrážka v ovládacím BulletedList prvku. Pokud chcete pro odrážky zadat vlastní obrázek, 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 potřeba sdělit pomocí technologie pro usnadnění. Pokud ale chcete k vyjádření konceptu uživateli použít vlastní obrázek, měli byste ke každé položkách 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 buď relativní, nebo absolutní cestu k obrázku. Relativní cesta spojuje 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řesunutí 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é