ListView.GroupPlaceholderID Propiedad
Definición
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 grupo en un control ListView.
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, setPublic Overridable Property GroupPlaceholderID As StringValor de propiedad
Identificador del marcador de posición de grupo en un control ListView. El valor predeterminado es "groupPlaceholder".
Excepciones
El identificador especificado es null o una cadena vacía.
Ejemplos
En el ejemplo siguiente se muestra cómo usar la GroupPlaceholderID propiedad para especificar un identificador diferente para el marcador de posición de grupo 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 GroupPlaceholderID propiedad para especificar un identificador para el marcador de posición de grupo. El marcador de posición de grupo es el control que se agrega a la LayoutTemplate plantilla cuando se usan grupos para representar dónde se representará el grupo.