匯出 (0) 列印
全部展開

DataList 類別

使用樣板 (Template) 顯示項目的資料繫結清單控制項。

命名空間: System.Web.UI.WebControls
組件: System.Web (在 system.web.dll 中)

[ControlValuePropertyAttribute("SelectedValue")] 
public class DataList : BaseDataList, INamingContainer, IRepeatInfoUser
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser
ControlValuePropertyAttribute("SelectedValue") 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser

使用 DataList 控制項,顯示樣板定義的資料繫結清單。DataList 控制項支援選取和編輯。

DataList 控制項的內容可使用樣板來操作。下列資料表列出所支援的樣板。

樣板名稱

說明

AlternatingItemTemplate

如果已定義,則提供 DataList 中替代項目的內容和配置。如果沒有定義,則會使用 ItemTemplate

EditItemTemplate

如果已定義,則提供目前正在 DataList 中編輯的項目的內容和配置。如果沒有定義,則會使用 ItemTemplate

FooterTemplate

如果已定義,則提供 DataList 的頁尾區段的內容和配置。如果沒有定義,頁尾區段將不會顯示。

HeaderTemplate

如果已定義,則提供 DataList 的頁首區段的內容和配置。如果沒有定義,頁首區段將不會顯示。

ItemTemplate

提供 DataList 中項目的內容和配置的必要樣板。

SelectedItemTemplate

如果已定義,則提供目前在 DataList 中所選取項目的內容和配置。如果沒有定義,就會使用 ItemTemplate

SeparatorTemplate

如果已定義,則提供 DataList 中項目之間分隔符號的內容和配置。如果沒有定義,分隔符號將不會顯示。

最低限度上,必須定義 ItemTemplate 以顯示 DataList 控制項中的項目。其他的樣板可用來為 DataList 控制項提供自訂外觀。

設定控制項不同部分的樣式屬性,可以自訂 DataList 控制項的外觀。下列資料表列出各種樣式屬性。

樣式屬性

說明

AlternatingItemStyle

指定 DataList 控制項中替代項目的樣式。

EditItemStyle

指定 DataList 控制項中正在編輯的項目的樣式。

FooterStyle

指定 DataList 控制項中頁尾的樣式。

HeaderStyle

指定 DataList 控制項中頁首的樣式。

ItemStyle

指定 DataList 控制項中項目的樣式。

SelectedItemStyle

指定 DataList 控制項中選取的項目的樣式。

SeparatorStyle

指定 DataList 控制項中項目之間分隔符號的樣式。

您也可以顯示或隱藏控制項的不同部分。下列資料表列出屬性,可控制哪個部分要顯示或隱藏。

屬性

說明

ShowFooter

顯示或隱藏 DataList 控制項的頁尾區段。

ShowHeader

顯示或隱藏 DataList 控制項的頁首區段。

DataList 控制項的顯示方向可以是垂直或水平的。設定 RepeatDirection 屬性以指定顯示方向。

DataList 控制項的配置以 RepeatLayout 屬性來控制。設定這個屬性為 RepeatLayout.Table 將會以資料表格式顯示 DataList,而 RepeatLayout.Flow 則不用資料表結構來顯示 DataList

Caution note警告

這個控制項可用來顯示使用者輸入,其中可能包含惡意用戶端指令碼。先檢查從用戶端傳送來的任何資訊,看是否有可執行的指令碼、SQL 陳述式或其他程式碼,然後再將此資訊顯示在應用程式中。您可以使用驗證控制項來驗證使用者輸入,再於控制項中顯示輸入文字。ASP.NET 提供了輸入要求驗證功能,可封鎖使用者輸入中的指令碼和 HTML。如需詳細資訊,請參閱 保護標準控制項HOW TO:利用將 HTML 編碼套用至字串的方法,防止會在 Web 應用程式中發生的指令碼攻擊驗證 ASP.NET Web 網頁中的使用者輸入

主題位置
HOW TO:建立 ASP.NET Web 伺服器控制項樣板建置 ASP .NET Web 應用程式
逐步解說:使用 DataList Web 伺服器控制項顯示並格式化資料在 Visual Studio 中建置 ASP .NET Web 應用程式
HOW TO:加入 DataList Web 伺服器控制項至 ASP.NET Web 網頁 (Visual Studio)在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:建立可以顯示 XML 資料的 Web 網頁在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:資料繫結至自訂的商務物件在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:使用轉換在 Web Form 網頁中顯示 XML 文件在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:在 Visual Web Developer 中建立和使用 ASP.NET 主版頁面在 Visual Studio 中建置 ASP .NET Web 應用程式
HOW TO:使用設計工具建立 Web 伺服器控制項樣板在 Visual Studio 中建置 ASP .NET Web 應用程式
HOW TO:在 Visual Studio 中繫結至樣板化控制項中的資料在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:在 Visual Studio 中建立主版/詳細資料 Web 網頁在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:在 Visual Web Developer 中建立和使用 ASP.NET 主版頁面使用 Visual Web Developer 建置應用程式
逐步解說:在 Visual Studio 中建立主從式 Web 網頁使用 Visual Web Developer 建置應用程式
HOW TO:在 DataList Web 伺服器控制項中動態自訂項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:允許使用者刪除 DataList Web 伺服器控制項中的項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:以宣告方式建立 ASP.NET Web 控制項樣板在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:指定 DataList Web 伺服器控制項中的水平或垂直配置在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:以程式設計方式加入控制項至 ASP.NET Web 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:使用 DataList Web 伺服器控制項顯示並格式化資料在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:使用設計工具建立 Web 伺服器控制項樣板在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:動態建立 ASP.NET Web 伺服器控制項樣板在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:允許使用者編輯 DataList Web 伺服器控制項中的項目在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:建立可以顯示 XML 資料的 Web 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:繫結至樣板化控制項中的資料在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:資料繫結至自訂的商務物件在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:允許使用者選取 DataList Web 伺服器控制項中的項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:將 DataList Web 伺服器控制項加入至 ASP.NET 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:在執行階段中自訂 DataList 項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:在 Visual Studio 中繫結至樣板化控制項中的資料在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:回應資料繫結控制項中的按鈕事件在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:指定 DataList Web 伺服器控制項中的流程或表格格式在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:回應 DataList 或 Repeater 項目中的按鈕事件在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:使用轉換在 Web Form 網頁中顯示 XML 文件在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:在 DataList Web 伺服器控制項中動態自訂項目建置 ASP .NET Web 應用程式
HOW TO:以宣告方式建立 ASP.NET Web 控制項樣板建置 ASP .NET Web 應用程式
HOW TO:允許使用者刪除 DataList Web 伺服器控制項中的項目建置 ASP .NET Web 應用程式
HOW TO:將 DataList 控制項加入至 ASP.NET Web 網頁建置 ASP .NET Web 應用程式
HOW TO:指定 DataList Web 伺服器控制項中的水平或垂直配置建置 ASP .NET Web 應用程式
HOW TO:以程式設計方式加入控制項至 ASP.NET Web 網頁建置 ASP .NET Web 應用程式
HOW TO:動態建立 ASP.NET Web 伺服器控制項樣板建置 ASP .NET Web 應用程式
HOW TO:允許使用者編輯 DataList Web 伺服器控制項中的項目建置 ASP .NET Web 應用程式
HOW TO:允許使用者選取 DataList Web 伺服器控制項中的項目建置 ASP .NET Web 應用程式
HOW TO:繫結至樣板化控制項中的資料建置 ASP .NET Web 應用程式
HOW TO:回應 DataList、Repeater 或 GridView 項目中的按鈕事件建置 ASP .NET Web 應用程式
HOW TO:在執行階段中自訂 DataList 項目建置 ASP .NET Web 應用程式
HOW TO:回應資料繫結控制項中的按鈕事件建置 ASP .NET Web 應用程式
HOW TO:指定 DataList Web 伺服器控制項中的流程或表格格式建置 ASP .NET Web 應用程式
HOW TO:在 DataList Web 伺服器控制項中動態自訂項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:允許使用者刪除 DataList Web 伺服器控制項中的項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:以宣告方式建立 ASP.NET Web 控制項樣板在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:指定 DataList Web 伺服器控制項中的水平或垂直配置在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:以程式設計方式加入控制項至 ASP.NET Web 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:使用 DataList Web 伺服器控制項顯示並格式化資料在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:使用設計工具建立 Web 伺服器控制項樣板在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:動態建立 ASP.NET Web 伺服器控制項樣板在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:允許使用者編輯 DataList Web 伺服器控制項中的項目在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:建立可以顯示 XML 資料的 Web 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:繫結至樣板化控制項中的資料在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:資料繫結至自訂的商務物件在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:允許使用者選取 DataList Web 伺服器控制項中的項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:將 DataList Web 伺服器控制項加入至 ASP.NET 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:在執行階段中自訂 DataList 項目在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:在 Visual Studio 中繫結至樣板化控制項中的資料在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:回應資料繫結控制項中的按鈕事件在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:指定 DataList Web 伺服器控制項中的流程或表格格式在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:回應 DataList 或 Repeater 項目中的按鈕事件在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:使用轉換在 Web Form 網頁中顯示 XML 文件在 Visual Studio 中建立 ASP .NET Web 應用程式

下列程式碼範例將示範如何使用 DataList 控制項,顯示資料來源中項目的清單。

Note注意事項

以下程式碼範例使用單一檔案程式碼模型,如果直接複製到程式碼後置 (Code-Behind) 檔案即可能無法作用。這個程式碼範例必須複製到副檔名為 .aspx 的空白文字檔。如需 Web Form 程式碼模型的詳細資訊,請參閱 ASP.NET Web 網頁程式碼模型


<%@ 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();
         }

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

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

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

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <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>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>


這個型別的所有公用靜態成員 (即 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、1.1、1.0

社群新增項目

新增
顯示:
© 2014 Microsoft