BulletedList クラスとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

BulletedList クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

行頭文字付き書式で項目のリストを生成するコントロールを作成します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class BulletedList
    Inherits ListControl
    Implements IPostBackEventHandler

Visual Basic (使用法)

Dim instance As BulletedList

public class BulletedList : ListControl, IPostBackEventHandler

C++

public ref class BulletedList : public
 ListControl, IPostBackEventHandler

public class BulletedList extends ListControl
 implements IPostBackEventHandler

JScript

public class BulletedList extends
 ListControl implements IPostBackEventHandler

解説

行頭文字を付加した書式で項目のリストを作成するには、BulletedList コントロールを使用します。BulletedList コントロールに表示する個々のリスト項目を指定するには、BulletedList コントロールの開始タグと終了タグの間の各エントリに ListItem オブジェクトを配置します。

BulletedList コントロールのリスト項目の表示に使用する行頭文字タイプを指定するには、BulletStyle プロパティに、BulletStyle 列挙値により定義されている行頭文字タイプの 1 つを設定します。使用できる行頭文字スタイルの一覧を次の表に示します。

行頭文字のスタイル	説明
NotSet	設定なし。
Numbered	数値。
LowerAlpha	英小文字。
UpperAlpha	英大文字。
LowerRoman	ローマ数字の小文字。
UpperRoman	ローマ数字の大文字。
Disc	黒丸。
Circle	白丸。
Square	黒い正方形。
CustomImage	カスタムイメージ。

番号付き BulletedList コントロールのリスト項目に付加する番号の開始値を指定するには、FirstBulletNumber プロパティを使用します。BulletStyle プロパティに Disc、Square、Circle、または CustomImage フィールドが設定されている場合、FirstBulletNumber プロパティに割り当てた値は無視されます。BulletStyle プロパティに CustomImage 値を設定して、行頭文字として使用するカスタムイメージを指定する場合は、BulletImageUrl プロパティにイメージファイルの場所を指定する必要があります。

BulletedList のリスト項目の表示動作を指定するには、DisplayMode プロパティに、BulletedListDisplayMode 列挙値により定義されている値の 1 つを設定します。定義されている表示動作は、Text、HyperLink、および LinkButton です。

ハイパーリンクがクリックされると、URL に移動します。ハイパーリンクの移動先の URL を指定するには、Value プロパティを使用します。ハイパーリンクがクリックされたときに移動する Web ページを表示するフレームまたはウィンドウを指定するには、Target プロパティを使用します。

DisplayMode プロパティに LinkButton を設定すると、BulletedList コントロールは、クリックしたときにサーバーにポストバックするリンクとしてリスト項目を表示します。リンクボタンがクリックされたときに実行されるアクションをプログラムによって制御するには、Click イベントのイベントハンドラを実装します。SelectedIndex および SelectedItem プロパティは ListControl クラスからの継承クラスなので、BulletedList コントロールには適用できません。BulletedList のクリックされたリンクボタンのインデックスを特定するには、BulletedListEventArgs クラスのイベントデータを使用します。

BulletedList コントロールはデータ連結もサポートしています。BulletedList をデータソースにバインドするには、提供されているデータバインディング機構のいずれかを使用します。詳細については、「データベースへのバインド」を参照してください。

ユーザー補助

このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

Topic	Location
方法 : BulletedList Web サーバーコントロールでのユーザーのクリックに応答する	ASP .NET Web アプリケーションの作成
方法 : BulletedList Web サーバーコントロールでユーザーのクリックに応答する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : Web フォームページに BulletedList Web サーバーコントロールを追加する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに BulletedList Web サーバーコントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : データソースのデータをリスト Web サーバーコントロールに読み込む	ASP .NET Web アプリケーションの作成
方法 : データソースの項目をリスト Web サーバーコントロールに読み込む (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールに項目を追加する	ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールに項目を追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

このセクションには、2 つのコード例が含まれています。1 番目のコード例は、リンクボタンで書式設定したリスト項目を持つ BulletedList コントロールを作成する方法を示しています。2 番目のコード例は、リスト項目を指定するためにデータバインディングを使用して BulletedList コントロールを作成する方法を示しています。

次のコード例は、リンクボタンで書式設定したリスト項目を持つ BulletedList コントロールを作成する方法を示しています。リスト項目をクリックすると、Label コントロールにテキストが表示されます。

Visual Basic

<%@ Page Language="VB" %>

<html>
<head>
    <script runat="server">

    Sub ItemsBulletedList_Click(ByVal sender
 As Object, ByVal e As
 System.Web.UI.WebControls.BulletedListEventArgs)
        ' Change the message displayed in the label based on the index
        ' of the list item that was clicked.
        Select Case (e.Index)
            Case 0
               Message.Text = "You clicked list item 1."
            Case 1
               Message.Text = "You clicked list item 2."
            Case 2
               Message.Text = "You clicked list item 3."
            Case 3
               Message.Text = "You clicked list item 4."
            Case Else
               Throw New Exception("You
 did not click a valid list item.")
        End Select

    End Sub

    </script>

</head>
<body>

    <h3>BulletedList Class Example</h3>

    <form runat="server">
            
        <h4>Click on an item in the list.</h4>
        
        <asp:BulletedList id="ItemsBulletedList"
 
            BulletStyle="Disc"
        DisplayMode="LinkButton" 
        OnClick="ItemsBulletedList_Click"
        runat="server">    
        <asp:ListItem Value="http://www.cohowinery.com">Coho
 Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso,
 Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin
 Toys</asp:ListItem>
        </asp:BulletedList>
                
    <asp:Label id="Message" 
        Font-Size="12"
            Font-Bold="True"
        Width="168px" 
        runat="server"/>
              
   </form>

</body>
</html>

次のコード例は、リスト項目を指定するためにデータバインディングを使用して BulletedList コントロールを作成する方法を示しています。リスト項目はリンクボタンで書式設定されています。リスト項目をクリックすると、Label コントロールにテキストが表示されます。

Visual Basic

<%@ Page Language="VB" %>

<html>
<head>

    <script runat="server">

        Sub ProductsBulletedList_Click(ByVal
 sender As Object, ByVal
 e As System.Web.UI.WebControls.BulletedListEventArgs)
            ' Change the message displayed in the label based on the
 index
            ' of the list item that was clicked.
            Select Case (e.Index)
                Case 0
                    Message.Text = "Product 1 was clicked"
                Case 1
                    Message.Text = "Product 2 was clicked"
                Case 2
                    Message.Text = "Product 3 was clicked"
                Case 3
                    Message.Text = "Product 4 was clicked"
                Case Else
                    Throw New Exception("You
 must click a valid list item.")
            End Select

        End Sub

    </script>
    
</head>
<body>

    <h3>BulletedList Class Data Binding Example</h3>

    <form ID="Form1" runat="server">
            
        <P>Click on an item in the list.</p>
            
        <P>
        <asp:BulletedList id="ProductsBulletedList"
 
            BulletStyle="Disc"
        DisplayMode="LinkButton" 
        DataTextField="ProductName"
        DataSourceID="SqlDataSource1"
        OnClick="ProductsBulletedList_Click"
        runat="server">                    
    </asp:BulletedList></P>
        
    <P>
    <asp:SqlDataSource id="SqlDataSource1"    
      
            ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
            runat="server"
            SelectCommand="SELECT * FROM [Products] Where ProductID
 < 5">
        </asp:SqlDataSource></P>
        
    <P>        
    <asp:Label id="Message" 
        Font-Size="12"
        Width="168px" 
        Font-Bold="True" 
        runat="server"/>                
              
   </form>

</body>
</html>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.BaseDataBoundControl
         System.Web.UI.WebControls.DataBoundControl
           System.Web.UI.WebControls.ListControl
            System.Web.UI.WebControls.BulletedList

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
BulletedList メンバ
System.Web.UI.WebControls 名前空間
BulletStyle
FirstBulletNumber
BulletImageUrl
DisplayMode
Click
ListItem
DataSourceControl
その他の技術情報
BulletedList Web サーバーコントロール