BulletedList.BulletImageUrl BulletedList.BulletImageUrl BulletedList.BulletImageUrl BulletedList.BulletImageUrl Property

定義

BulletedList コントロールに行頭文字として表示するイメージへのパスを取得または設定します。Gets or sets the path to an image to display for each bullet in a BulletedList control.

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

プロパティ値

BulletedList に行頭文字として表示するイメージへのパス。The path to an image to display as each bullet in a BulletedList.

次のコード例は、 BulletedListコントロールを作成し、 BulletImageUrlプロパティを設定して、各箇条書きに使用するカスタムイメージへのパスを指定する方法を示しています。The following code example demonstrates how to create a BulletedList control and set the BulletImageUrl property to specify the path to a custom image to use for each bullet.

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

注釈

プロパティを使用して、 BulletedListコントロールの各行頭文字として表示するイメージへのパスを指定します。 BulletImageUrlUse the BulletImageUrl property to specify the path to an image to display as each bullet in a BulletedList control. 箇条書きのカスタムイメージを指定するには、 BulletStyleプロパティを値CustomImageに設定する必要もあります。To specify a custom image for the bullets, you must also set the BulletStyle property to the value CustomImage.

注意

箇条書きは本質的には装飾AlternateText的であり、補助技術によって伝達する必要がある追加情報を提供しないため、コントロールはプロパティをサポートしていません。BulletedListThe BulletedList control does not support the AlternateText property because the bullets are inherently decorative and do not provide additional information that needs to be conveyed via assistive technology. ただし、カスタムイメージを使用してユーザーに概念を伝える場合は、各箇条書き項目にテキストを追加するか、各イメージの代替テキストを指定するためのコントロールを使用する必要があります。However, if you want to use a custom image to convey a concept to the user, you should add additional text to each of the bulleted list items or use a control that allows you to specify alternate text for each image.

イメージへの相対パスまたは絶対パスを指定できます。You can specify either a relative or an absolute path to the image. 相対パスは、サーバーの完全なパスを指定せずに、イメージの場所を Web ページの場所に関連付けます。A relative path relates the location of the image to the location of the Web page without specifying a complete path on the server. パスは、Web ページの場所を基準とした相対パスです。The path is relative to the location of the Web page. これにより、コードを更新しなくても、サイト全体をサーバー上の別のディレクトリに移動しやすくなります。This makes it easier to move the entire site to another directory on the server without updating the code.

次のコード例は、イメージファイルへの相対パスを示しています。The following code example shows a relative path to an image file:

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

次のコード例は、イメージファイルへの絶対パスを示しています。The following code example shows an absolute path to an image file:

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

このプロパティの値は、ビューステートに格納されます。The value of this property is stored in view state.

適用対象

こちらもご覧ください