BulletedList.BulletImageUrl Właściwość

Definicja

Pobiera lub ustawia ścieżkę do obrazu, aby wyświetlić dla każdego punktora w kontrolce 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

Wartość właściwości

String

Ścieżka do obrazu do wyświetlenia jako każdy punktor w elemecie BulletedList.

Przykłady

Poniższy przykład kodu pokazuje, jak utworzyć kontrolkę BulletedList i ustawić BulletImageUrl właściwość, aby określić ścieżkę do obrazu niestandardowego do użycia dla każdego punktora.

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

Uwagi

BulletImageUrl Użyj właściwości , aby określić ścieżkę do obrazu do wyświetlenia jako każdy punktor w kontrolceBulletedList. Aby określić obraz niestandardowy dla punktorów, należy również ustawić BulletStyle właściwość na wartość CustomImage.

Uwaga

Kontrolka BulletedList nie obsługuje AlternateText właściwości, ponieważ kulki są z natury dekoracyjne i nie dostarczają dodatkowych informacji, które należy przekazać za pośrednictwem technologii pomocniczej. Jeśli jednak chcesz użyć obrazu niestandardowego do przekazania koncepcji użytkownikowi, należy dodać dodatkowy tekst do każdego z punktowanych elementów listy lub użyć kontrolki, która umożliwia określenie alternatywnego tekstu dla każdego obrazu.

Możesz określić względną lub bezwzględną ścieżkę do obrazu. Ścieżka względna odnosi lokalizację obrazu do lokalizacji strony sieci Web bez określania pełnej ścieżki na serwerze. Ścieżka jest względna względem lokalizacji strony sieci Web. Ułatwia to przenoszenie całej lokacji do innego katalogu na serwerze bez aktualizowania kodu.

Poniższy przykład kodu przedstawia ścieżkę względną do pliku obrazu:

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

Poniższy przykład kodu przedstawia ścieżkę bezwzględną do pliku obrazu:

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

Wartość tej właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też