DataList.SeparatorTemplate プロパティとは何？わかりやすく解説 Weblio辞書

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

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

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

DataList.SeparatorTemplate プロパティ

DataList コントロールの項目間の区切り記号のテンプレートを取得または設定します。

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

Visual Basic (宣言)

<TemplateContainerAttribute(GetType(DataListItem))> _
Public Overridable Property
 SeparatorTemplate As ITemplate

Visual Basic (使用法)

Dim instance As DataList
Dim value As ITemplate

value = instance.SeparatorTemplate

instance.SeparatorTemplate = value

[TemplateContainerAttribute(typeof(DataListItem))] 
public virtual ITemplate SeparatorTemplate { get;
 set; }

C++

[TemplateContainerAttribute(typeof(DataListItem))] 
public:
virtual property ITemplate^ SeparatorTemplate {
    ITemplate^ get ();
    void set (ITemplate^ value);
}

/** @property */
public ITemplate get_SeparatorTemplate ()

/** @property */
public void set_SeparatorTemplate (ITemplate
 value)

JScript

public function get SeparatorTemplate
 () : ITemplate

public function set SeparatorTemplate
 (value : ITemplate)

プロパティ値
DataList コントロールの項目間の区切り記号のテンプレートを格納している System.Web.UI.ITemplate。既定値は null 参照 (Visual Basic では Nothing) です。

解説

SeparatorTemplate プロパティを使用して、DataList コントロールの項目間の区切り記号の内容を制御します。区切り記号を使用すると、DataList コントロールの各項目間にカスタム内容の要素を配置できます。DataList コントロールの項目間の区切り記号の外観は、SeparatorStyle プロパティによって制御されます。

区切り記号のテンプレートを指定するには、<SeparatorTemplate> タグを DataList コントロールの開始タグと終了タグの間に配置します。その後、<SeparatorTemplate> の開始タグと終了タグの間に、テンプレートの内容のリストを記述できます。

注意
このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検証してください。入力テキストをコントロールに表示する前に、検証コントロールを使用してユーザー入力を検証できます。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトおよび HTML をブロックできます。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。

注意

このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検証してください。入力テキストをコントロールに表示する前に、検証コントロールを使用してユーザー入力を検証できます。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトおよび HTML をブロックできます。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。

Topic	Location
方法 : ASP.NET Web サーバーコントロールのテンプレートを作成する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET Web サーバーコントロールのテンプレートを宣言によって作成する	ASP .NET Web アプリケーションの作成

使用例

SeparatorTemplate プロパティを使用して、DataList コントロールの各項目間の区切り記号の内容を制御する方法のコード例を次に示します。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
<%@ Import Namespace="System.Data"
 %>
 
<html>
   <script runat="server">
 
      Function CreateDataSource() As ICollection
 
      
         ' Create sample data for the DataList control.
         Dim dt As DataTable = New
 DataTable()
         dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue",
 GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue",
 GetType(String)))
         dt.Columns.Add(New DataColumn("CurrencyValue",
 GetType(Double)))
         dt.Columns.Add(New DataColumn("ImageValue",
 GetType(String)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 To 8 

            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Description for item " &
 i.ToString()
            dr(2) = 1.23 * (i + 1)
            dr(3) = "Image" & i.ToString() &
 ".jpg"
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New
 DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object,
 e As EventArgs) 

         ' Load sample data only once when, the page is first loaded.
         If Not IsPostBack Then
 
     
            ItemsList.DataSource = CreateDataSource()
            ItemsList.DataBind()
         
         End If

      End Sub

      Sub Selection_Change(sender As Object,
 e As EventArgs)

         ' Set the background color for the separator section of
         ' the DataList control.
         ItemsList.SeparatorStyle.BackColor = _
             System.Drawing.Color.FromName(ItemList.SelectedItem.Value)

      End Sub
 
   </script>
 
<body>
 
   <form runat=server>

      <h3>DataList SeparatorTemplate and SeparatorStyle
 Example</h3>

      Select a background color for the separator
 between 
      items in the DataList.

      <br><br>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           ShowBorder="True"
           ShowFooter="True"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <ItemStyle BackColor="Silver">
         </ItemStyle>

         <AlternatingItemStyle BackColor="DarkGray">
         </AlternatingItemStyle>

         <SeparatorStyle BackColor="White">
         </SeparatorStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br>
            <%# DataBinder.Eval(Container.DataItem, "StringValue")
 %>

            <br>

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue",
 "{0:c}") %>

            <br>

            <asp:Image id="ProductImage"
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem,
 "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>

         <SeparatorTemplate>

            <asp:Image id="SeparatorImage"
                 ImageUrl="SeparatorImage.jpg"
                 runat="server"/>

         </SeparatorTemplate>
 
      </asp:DataList>

      <hr>

      <table cellpadding="5">

         <tr>

            <td>

               Separator BackColor:
 
            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ItemList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True"
 Value="White"> White </asp:ListItem>
                  <asp:ListItem Value="Silver">
 Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray">
 Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki">
 Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki">
 Dark Khaki </asp:ListItem>

               </asp:DropDownList>
 
            </td>

         </tr>

      </table>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue",
 typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue",
 typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue",
 typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue",
 typeof(String)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
  
      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }

      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the background color for the separator section of
         // the DataList control.
         ItemsList.SeparatorStyle.BackColor = 
             System.Drawing.Color.FromName(ItemList.SelectedItem.Value);

      }
 
   </script>
 
<body>
 
   <form runat=server>

      <h3>DataList SeparatorTemplate and SeparatorStyle Example</h3>

      Select a background color for the separator between 
      items in the DataList.

      <br><br>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           ShowBorder="True"
           ShowFooter="True"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <ItemStyle BackColor="Silver">
         </ItemStyle>

         <AlternatingItemStyle BackColor="DarkGray">
         </AlternatingItemStyle>

         <SeparatorStyle BackColor="White">
         </SeparatorStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br>
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br>

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue",
 "{0:c}") %>

            <br>

            <asp:Image id="ProductImage"
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue")
 %>'
                 runat="server"/>

         </ItemTemplate>

         <SeparatorTemplate>

            <asp:Image id="SeparatorImage"
                 ImageUrl="SeparatorImage.jpg"
                 runat="server"/>

         </SeparatorTemplate>
 
      </asp:DataList>

      <hr>

      <table cellpadding="5">

         <tr>

            <td>

               Separator BackColor:
 
            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ItemList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True" Value="White">
 White </asp:ListItem>
                  <asp:ListItem Value="Silver"> Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>

               </asp:DropDownList>
 
            </td>

         </tr>

      </table>
 
   </form>
 
</body>
</html>

プラットフォーム

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、1.1、1.0

参照

関連項目
DataList クラス
DataList メンバ
System.Web.UI.WebControls 名前空間
System.Web.UI.ITemplate
DataList.SeparatorStyle プロパティ
その他の技術情報
DataList Web サーバーコントロール
ASP.NET Web ページのコードモデル

このページでは「.NET Framework クラスライブラリリファレンス」からDataList.SeparatorTemplate プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からDataList.SeparatorTemplate プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からDataList.SeparatorTemplate プロパティを検索

>> 「DataList.SeparatorTemplate プロパティ」を含む用語の索引
DataList.SeparatorTemplate プロパティのページへのリンク

DataList.SeparatorTemplate プロパティとは？わかりやすく解説

DataList.SeparatorTemplate プロパティ

「DataList.SeparatorTemplate プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

DataList.SeparatorTemplate プロパティとは？ わかりやすく解説

DataList.SeparatorTemplate プロパティ

急上昇のことば

「DataList.SeparatorTemplate プロパティ」の関連用語

DataList.SeparatorTemplate プロパティとは？わかりやすく解説