Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad CheckBoxList.RepeatDirection

 

Publicado: octubre de 2016

Obtiene o establece un valor que indica si el control se muestra en vertical o en horizontal.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

public virtual RepeatDirection RepeatDirection { get; set; }

Valor de propiedad

Type: System.Web.UI.WebControls.RepeatDirection

Uno de los valores de RepeatDirection. De manera predeterminada, es Vertical.

Exception Condition
ArgumentOutOfRangeException

La dirección de la lista de presentación especificado no es uno de los RepeatDirection valores.

Utilice esta propiedad para especificar la dirección de presentación de la CheckBoxList control.

System_CAPS_noteNota

El número de columnas mostradas siempre viene determinado por la RepeatColumns propiedad.

Si esta propiedad se establece en RepeatDirection.Vertical y si la RepeatLayout propiedad se establece en Table, se rellena la primera columna de arriba a abajo, a continuación, la columna siguiente, y así sucesivamente hasta que se procesan todos los elementos. Por ejemplo, si la RepeatColumns propiedad se establece en 3, los elementos de la CheckBoxList control se muestran en tres columnas, como se muestra en la tabla siguiente.

1

4

7

2

5

8

3

6

9

Si esta propiedad se establece en RepeatDirection.Horizontal y si la RepeatLayout propiedad se establece en Table, se rellena la primera columna de arriba a abajo, a continuación, la columna siguiente, y así sucesivamente hasta que se procesan todos los elementos. Por ejemplo, si la RepeatColumns propiedad se establece en 3, los elementos de la CheckBoxList control se muestran en filas de tres elementos cada una, como en la tabla siguiente.

1

2

3

4

5

6

7

8

9

En el ejemplo de código siguiente se muestra cómo establecer el RepeatDirection propiedad para especificar que la dirección de presentación es vertical.

System_CAPS_noteNota

Ejemplos de código siguientes usan el modelo de código de un solo archivo y pueden no funcionar correctamente si se copia directamente en un archivo de código subyacente. Cada ejemplo de código debe copiarse en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de formularios Web Forms, vea ASP.NET Web Forms Page Code Model.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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" >
<head>
    <title>CheckBoxList Example</title>
<script language="C#" runat="server">

   void Check_Clicked(Object sender, EventArgs e) 
   {
      Message.Text = "Selected Item(s):<br /><br />";
      for (int i = 0; i < CheckBoxList1.Items.Count; i++)
      {
         if (CheckBoxList1.Items[i].Selected)
            Message.Text += CheckBoxList1.Items[i].Text + "<br />";
      }
   }

</script>

</head>
<body>

   <form id="form1" action="CheckBoxList.aspx" method="post" runat="server">

      <h3>CheckBoxList Example</h3>

      <asp:CheckBoxList id="CheckBoxList1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:CheckBoxList>

      <br /><br />

      <asp:label id="Message" runat="server"/>

   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<!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" >

<head runat="server">
    <title> CheckBoxList RepeatDirection Example </title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br /><br />";

         // Iterate through the Items collection of the CheckBoxList
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count; i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br />";

            }

         }

      }

      void Index_Change(Object sender, EventArgs e) 
      {

         // Set the direction that the items are rendered in the 
         // CheckBoxList control.
         checkboxlist1.RepeatDirection = (RepeatDirection)List.SelectedIndex;

      }

   </script>

</head>

<body>

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

      <h3> CheckBoxList RepeatDirection Example </h3>

      Select items from the CheckBoxList.

      <br /><br />

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:CheckBoxList>

      <br /><br />

      <asp:label id="Message" runat="server"/>

      <hr />

      Select the direction to render the CheckBoxList items.

      <table cellpadding="5">

         <tr>

            <td>

               RepeatDirection:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="List"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Index_Change"
                    runat="server">

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

               </asp:DropDownList>

            </td>

         </tr>

      </table>

   </form>

</body>

</html>

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: