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 していません。 ただし、カスタム イメージを使用して概念をユーザーに伝える場合は、箇条書きの各項目にテキストを追加するか、画像ごとに代替テキストを指定できるコントロールを使用する必要があります。

イメージへの相対パスまたは絶対パスを指定できます。 相対パスは、サーバー上の完全なパスを指定せずに、イメージの場所を Web ページの場所に関連付けます。 パスは、Web ページの場所に対する相対パスです。 これにより、コードを更新することなく、サイト全体をサーバー上の別のディレクトリに簡単に移動できます。

次のコード例は、イメージ ファイルへの相対パスを示しています。

\\Images\\image1.jpg

"Images\image1.jpg"

次のコード例は、イメージ ファイルへの絶対パスを示しています。

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

"c"\MyImagesDir\image1.jpg"

このプロパティの値はビュー ステートに格納されます。

適用対象

こちらもご覧ください