Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataList.RepeatDirection-Eigenschaft

.NET Framework 3.5

Andere Versionen

Aktualisiert: November 2007

Ruft ab oder legt fest, ob das DataList-Steuerelement vertikal oder horizontal angezeigt wird.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public virtual RepeatDirection RepeatDirection { get; set; }

/** @property */
public RepeatDirection get_RepeatDirection()
/** @property */
public  void set_RepeatDirection(RepeatDirection value)

JScript

public function get RepeatDirection () : RepeatDirection
public function set RepeatDirection (value : RepeatDirection)

ASP.NET

<asp:DataList RepeatDirection="RepeatDirection" />

Eigenschaftenwert

Typ: System.Web.UI.WebControls.RepeatDirection
Einer der RepeatDirection-Werte. Der Standardwert ist Vertical.

Ausnahmen

Ausnahme	Bedingung
ArgumentOutOfRangeException	Der angegebene Wert ist keiner der RepeatDirection-Werte.

Hinweise

Mit der RepeatDirection-Eigenschaft geben Sie die Anzeigerichtung des DataList-Steuerelements an.

Hinweis:
Die Anzahl der angezeigten Spalten wird immer durch die RepeatColumns-Eigenschaft bestimmt.

Wenn diese Eigenschaft auf RepeatDirection.Vertical festgelegt ist, werden die Elemente der Liste in Spalten angezeigt, die von oben nach unten und dann von links nach rechts geladen werden, bis alle Elemente dargestellt sind. Wenn die RepeatColumns-Eigenschaft z. B. auf 3 festgelegt ist, werden die Elemente im DataList-Steuerelement wie in der folgenden Tabelle in drei Spalten angezeigt.

1	4	7
2	5	8
3	6	9

Wenn diese Eigenschaft auf RepeatDirection.Horizontal festgelegt ist, werden die Elemente der Liste in Zeilen angezeigt, die von links nach rechts und dann von oben nach unten geladen werden, bis alle Elemente dargestellt sind. Wenn die RepeatColumns-Eigenschaft z. B. auf 3 festgelegt ist, werden die Element des DataList-Steuerelements wie in der folgenden Tabelle in Zeilen mit je drei Elementen angezeigt.

1	2	3
4	5	6
7	8	9

Topic	Location
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-Webserversteuerelementen	Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-Webserversteuerelementen	Erstellen von ASP.NET-Webanwendungen in Visual Studio

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie mit der RepeatDirection-Eigenschaft die Richtung angegeben wird, in der das DataList-Steuerelement angezeigt wird.

Hinweis:
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine Code-Behind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung .aspx kopiert werden. Weitere Informationen über das Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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" >
   <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 Button_Click(Object sender, EventArgs e) 
      {

         // Set the repeat direction based on the selected value of the
         // DirectionList DropDownList control.
         ItemsList.RepeatDirection = 
             (RepeatDirection)DirectionList.SelectedIndex;

         // Set the repeat layout based on the selected value of the
         // LayoutList DropDownList control.
         ItemsList.RepeatLayout = (RepeatLayout)LayoutList.SelectedIndex;

         // Set the number of columns to display based on the selected
         // value of the ColumnsList DropDownList control.
         ItemsList.RepeatColumns = ColumnsList.SelectedIndex;

         // Show or hide the gridlines based on the value of the
         // ShowBorderCheckBox property. Note that gridlines are displayed
         // only if the RepeatLayout property is set to Table.
         if ((ShowBorderCheckBox.Checked) 
             && (ItemsList.RepeatLayout == RepeatLayout.Table)) 
         {
            ItemsList.BorderWidth = Unit.Pixel(1);
            ItemsList.GridLines = GridLines.Both;
         }    
         else  
         {
            ItemsList.BorderWidth = Unit.Pixel(0);
            ItemsList.GridLines = GridLines.None;
         }

      }    

   </script>

<head runat="server">
    <title>DataList Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataList Example</h3>

      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="0"
           BorderWidth="0"
           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"
                 AlternatingText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>'
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>

      </asp:DataList>

      <hr />

      <table cellpadding="5">

         <tr>

            <th>

               Repeat direction:

            </th>

            <th>

               Repeat layout:

            </th>

            <th>

               Repeat columns:

            </th>

            <th>

               <asp:CheckBox id="ShowBorderCheckBox"
                    Text="Show border"
                    Checked="False" 
                    runat="server" />

            </th>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="DirectionList" 
                    runat="server">

                  <asp:ListItem>Horizontal</asp:ListItem>
                  <asp:ListItem Selected="True">Vertical</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

               <asp:DropDownList id="LayoutList" 
                    runat="server">

                  <asp:ListItem Selected="True">Table</asp:ListItem>
                  <asp:ListItem>Flow</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

               <asp:DropDownList id="ColumnsList" 
                    runat="server">

                  <asp:ListItem Selected="True">0</asp:ListItem>
                  <asp:ListItem>1</asp:ListItem>
                  <asp:ListItem>2</asp:ListItem>
                  <asp:ListItem>3</asp:ListItem>
                  <asp:ListItem>4</asp:ListItem>
                  <asp:ListItem>5</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

               &nbsp;

            </td>


         </tr>

      </table>     

      <asp:LinkButton id="RefreshButton" 
           Text="Refresh DataList" 
           OnClick="Button_Click" 
           runat="server"/>

   </form>

</body>
</html>

Plattformen

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

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen