Repeater.AlternatingItemTemplate プロパティ

  • [アーティクル]

コントロールの交互の項目を表示する方法を定義する System.Web.UI.ITemplate を取得または設定します。

Public Overridable Property AlternatingItemTemplate As ITemplate
[C#]
public virtual ITemplate AlternatingItemTemplate {get; set;}
[C++]
public: __property virtual ITemplate* get_AlternatingItemTemplate();public: __property virtual void set_AlternatingItemTemplate(ITemplate*);
[JScript]
public function get AlternatingItemTemplate() : ITemplate;public function set AlternatingItemTemplate(ITemplate);

プロパティ値

交互の項目の表示方法を定義する System.Web.UI.ITemplate 。既定値は null 参照 (Visual Basic では Nothing) です。

解説

このプロパティを使用して、 Repeater コントロール内の交互の項目に、 ItemTemplate で指定したものとは異なる外観を適用します。

注意   このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアント スクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバー コントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「 検証サーバー コントロール 」を参照してください。

使用例

[Visual Basic, C#] AlternatingItemTemplate を使用して、 Repeater の交互の項目を太字フォントで水色のセルに表示する方法の例を次に示します。

 
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <head>
    <script language="VB" runat="server">

    Sub Page_Load(Sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            Dim values As New ArrayList()
            
            values.Add("Apple")
            values.Add("Orange")
            values.Add("Pear")
            values.Add("Banana")
            values.Add("Grape")
            
            Repeater1.DataSource = values
            Repeater1.DataBind()
        End If
    End Sub
    
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td style="background-color: lightblue">
                   <b><%# Container.DataItem %></b> 
                </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td style="background-color: lightgray"> 
                   <%# Container.DataItem %> 
                </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>
 

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
    <script language="C#" runat="server">
       void Page_Load(Object Sender, EventArgs e) {
 
          if (!IsPostBack) {
             ArrayList values = new ArrayList();
 
             values.Add("Apple");
             values.Add("Orange");
             values.Add("Pear");
             values.Add("Banana");
             values.Add("Grape");
 
             Repeater1.DataSource = values;
             Repeater1.DataBind();
          }
       }
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td style="background-color: lightblue">
                   <b><%# Container.DataItem %></b> 
                </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td style="background-color: lightgray"> 
                   <%# Container.DataItem %> 
                </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

Repeater クラス | Repeater メンバ | System.Web.UI.WebControls 名前空間 | ItemTemplate | HeaderTemplate | FooterTemplate | SeparatorTemplate