ListView.GroupPlaceholderID Свойство

Определение

Возвращает или задает идентификатор для местозаполнителя группы в элементе управления ListView.Gets or sets the ID for the group placeholder in a ListView control.

public:
 virtual property System::String ^ GroupPlaceholderID { System::String ^ get(); void set(System::String ^ value); };
public virtual string GroupPlaceholderID { get; set; }
member this.GroupPlaceholderID : string with get, set
Public Overridable Property GroupPlaceholderID As String

Значение свойства

Идентификатор для местозаполнителя группы в элементе управления ListView.The ID for the group placeholder in a ListView control. Значение по умолчанию — "groupPlaceholder".The default is "groupPlaceholder".

Исключения

Указанный идентификатор имеет значение null (пустая строка).The specified ID is null or an empty string.

Примеры

В следующем примере показано, как использовать GroupPlaceholderID свойство, чтобы указать другой идентификатор для заполнителя ListView группы элемента управления.The following example shows how to use the GroupPlaceholderID property to specify a different ID for the group placeholder of the 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>

Комментарии

GroupPlaceholderID Используйте свойство, чтобы указать идентификатор заполнителя группы.Use the GroupPlaceholderID property to specify an ID for the group placeholder. Заполнитель группы — это элемент управления, добавляемый в LayoutTemplate шаблон при использовании групп для представления места, где будет производиться визуализация группы.The group placeholder is the control that you add to the LayoutTemplate template when you are using groups to represent where the group will be rendered.

Применяется к

Дополнительно