共用方式為

BulletedList.BulletImageUrl 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定要顯示成 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

屬性值

String

要顯示成 BulletedList 中各個項目符號之影像的路徑。

範例

下列程式代碼範例示範如何建立 BulletedList 控件，並設定 BulletImageUrl 屬性，以指定要用於每個項目符號的自定義影像路徑。

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

備註

BulletImageUrl使用屬性可指定要顯示為控件中BulletedList每個項目符號之影像的路徑。 若要指定項目符號的自訂影像，您也必須將 BulletStyle 屬性設定為 值 CustomImage。

注意

BulletedList控件不支援 AlternateText 屬性，因為項目符號原本是裝飾性的，而且不會提供需要透過輔助技術傳達的其他資訊。 不過，如果您想要使用自定義影像來傳達概念給使用者，您應該將額外的文字新增至每個點符清單專案，或使用可讓您為每個影像指定替代文字的控件。

您可以指定影像的相對路徑或絕對路徑。 相對路徑會將影像的位置與網頁的位置建立關聯，而不需在伺服器上指定完整路徑。 路徑相對於網頁的位置。 這可讓您更輕鬆地將整個月臺移至伺服器上的另一個目錄，而不需更新程序代碼。

下列程式代碼範例顯示影像檔案的相對路徑：

\\Images\\image1.jpg

"Images\image1.jpg"

下列程式代碼範例顯示影像檔案的絕對路徑：

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

"c"\MyImagesDir\image1.jpg"

此屬性的值會儲存在檢視狀態中。

適用於

另請參閱