ListView.ItemPlaceholderID Propiedad

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.Extensions.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece el identificador del marcador de posición de elemento en un control ListView.

public:
 virtual property System::String ^ ItemPlaceholderID { System::String ^ get(); void set(System::String ^ value); };

public virtual string ItemPlaceholderID { get; set; }

member this.ItemPlaceholderID : string with get, set

Public Overridable Property ItemPlaceholderID As String

Valor de propiedad

String

Identificador del marcador de posición de elemento en un control ListView. El valor predeterminado es "itemPlaceholder".

Excepciones

ArgumentOutOfRangeException

El identificador especificado es null o una cadena vacía.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la ItemPlaceholderID propiedad para especificar un identificador para el marcador de posición de elemento del ListView control.

<%@ Page language="C#" %>
    
<!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 id="Head1" runat="server">
    <title>ListView GroupContainerID and ItemContainerID Example</title>
    <style type="text/css">
      body
      {
          font: 10pt Trebuchet MS, Arial, Tahoma; 
          text-align: center;
      }
      th { background: #b7cfff; }
      .item
      {
          border: 1px dashed #a4cbf4;
          background: white;
          min-height: 19px;
          width: 33%;
      }
      .alternatingItem
      {
        border: solid 1px #a4cbf4;
        background: #edf5fd;
        width: 33%;
        min-height: 19px;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView GroupContainerID and ItemContainerID Example</h3>
      
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        GroupItemCount="3"
        GroupPlaceholderID="ContactRowContainer"
        ItemPlaceholderID="ContactItemContainer"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="4" width="640px" runat="server" id="tblContacts">
            <tr runat="server">
              <th colspan="3" runat="server">Contacts</th>
            </tr>
            <tr runat="server" id="ContactRowContainer" />
          </table>
          <asp:DataPager ID="ContactsDataPager" runat="server" PageSize="30">
            <Fields>
              <asp:NumericPagerField ButtonCount="10" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <GroupTemplate>
          <tr runat="server" id="ContactRow">
            <td runat="server" id="ContactItemContainer" />
          </tr>
        </GroupTemplate>
        <ItemTemplate>
          <td class="item" runat="server">
            <asp:Label ID="NameLabel" runat="server" 
              Text='<%# Eval("LastName") + ", " + Eval("FirstName")%>' />
          </td>
        </ItemTemplate>
        <AlternatingItemTemplate>
          <td class="alternatingItem" runat="server">
            <asp:Label ID="NameLabel" runat="server" 
              Text='<%# Eval("LastName") + ", " + Eval("FirstName")%>' />
          </td>
        </AlternatingItemTemplate>
      </asp:ListView>
      
      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->      
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [FirstName], [LastName] 
          FROM Person.Contact ORDER BY [LastName], [FirstName] ">
      </asp:SqlDataSource>

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

<%@ Page language="VB" %>
    
<!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 id="Head1" runat="server">
    <title>ListView GroupContainerID and ItemContainerID Example</title>
    <style type="text/css">
      body
      {
          font: 10pt Trebuchet MS, Arial, Tahoma; 
          text-align: center;
      }
      th { background: #b7cfff; }
      .item
      {
          border: 1px dashed #a4cbf4;
          background: white;
          min-height: 19px;
          width: 33%;
      }
      .alternatingItem
      {
        border: solid 1px #a4cbf4;
        background: #edf5fd;
        width: 33%;
        min-height: 19px;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView GroupContainerID and ItemContainerID Example</h3>
      
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        GroupItemCount="3"
        GroupPlaceholderID="ContactRowContainer"
        ItemPlaceholderID="ContactItemContainer"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="4" width="640px" runat="server" id="tblContacts">
            <tr id="Tr1" runat="server">
              <th id="Th1" colspan="3" runat="server">Contacts</th>
            </tr>
            <tr runat="server" id="ContactRowContainer" />
          </table>
          <asp:DataPager ID="ContactsDataPager" runat="server" PageSize="30">
            <Fields>
              <asp:NumericPagerField ButtonCount="10" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <GroupTemplate>
          <tr runat="server" id="ContactRow">
            <td runat="server" id="ContactItemContainer" />
          </tr>
        </GroupTemplate>
        <ItemTemplate>
          <td id="Td1" class="item" runat="server">
            <asp:Label ID="NameLabel" runat="server" 
              Text='<%# Eval("LastName") & ", " & Eval("FirstName")%>' />
          </td>
        </ItemTemplate>
        <AlternatingItemTemplate>
          <td id="Td2" class="alternatingItem" runat="server">
            <asp:Label ID="NameLabel" runat="server" 
              Text='<%# Eval("LastName") & ", " & Eval("FirstName")%>' />
          </td>
        </AlternatingItemTemplate>
      </asp:ListView>
      
      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->      
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [FirstName], [LastName] 
          FROM Person.Contact ORDER BY [LastName], [FirstName] ">
      </asp:SqlDataSource>

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

Comentarios

Utilice la ItemPlaceholderID propiedad para especificar un identificador para el marcador de posición del elemento. El marcador de posición de elemento es el control que agrega a la LayoutTemplate plantilla (si no usa grupos) o a la GroupTemplate plantilla (si usa grupos) para representar dónde se representará el elemento.

Se aplica a

Compartir vía