DataPager.PagedControlID Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
public:
virtual property System::String ^ PagedControlID { System::String ^ get(); void set(System::String ^ value); };[System.Web.UI.Themeable(false)]
public virtual string PagedControlID { get; set; }[<System.Web.UI.Themeable(false)>]
member this.PagedControlID : string with get, setPublic Overridable Property PagedControlID As StringValor da propriedade
O ID do controle que contém os dados que serão paginados pelo controle DataPager. O padrão é uma cadeia de caracteres vazia, que indica que essa propriedade não está definida.
- Atributos
Exemplos
O exemplo a seguir mostra como usar a PagedControlID propriedade para associar dinamicamente um ListView controle a um DataPager controle. Este exemplo de código faz parte de um exemplo maior fornecido para o DataPager construtor.
protected void Page_Load(object sender, EventArgs e)
{
// Create a new DataPager object.
DataPager CountryDataPager = new DataPager();
// Set the DataPager object's properties.
CountryDataPager.PagedControlID = CountryListView.ID;
CountryDataPager.PageSize = 15;
CountryDataPager.Fields.Add(new NumericPagerField());
// Add the DataPager object to the Controls collection
// of the form.
form1.Controls.Add(CountryDataPager);
CountryListView.DataBind();
}
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Create a new DataPager object.
Dim CountryDataPager As New DataPager()
' Set the DataPager object's properties.
CountryDataPager.PagedControlID = CountryListView.ID
CountryDataPager.PageSize = 15
CountryDataPager.Fields.Add(New NumericPagerField())
' Add the DataPager object to the Controls collection
' of the form.
form1.Controls.Add(CountryDataPager)
CountryListView.DataBind()
End Sub
O exemplo a seguir mostra como definir declarativamente a PagedControlID propriedade em um DataPager controle para paginar os dados de um ListView controle.
<%@ 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>DataPager PagedControlID Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataPager PagedControlID Example</h3>
<asp:DataPager ID="DepartmentsPager" runat="server"
PagedControlID="DepartmentsListView">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
<asp:ListView ID="DepartmentsListView"
DataSourceID="DepartmentsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="500px">
<tr>
<th>Department Name</th>
<th>Group</th>
</tr>
<tr runat="server" id="itemPlaceholder"></tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' />
</td>
<td>
<asp:Label ID="GroupNameLabel" runat="server" Text='<%# Eval("GroupName") %>' />
</td>
</tr>
</ItemTemplate>
</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="DepartmentsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT Name, GroupName FROM HumanResources.Department" >
</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>DataPager PagedControlID Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataPager PagedControlID Example</h3>
<asp:DataPager ID="DepartmentsPager" runat="server"
PagedControlID="DepartmentsListView">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
<asp:ListView ID="DepartmentsListView"
DataSourceID="DepartmentsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="500px">
<tr>
<th>Department Name</th>
<th>Group</th>
</tr>
<tr runat="server" id="itemPlaceholder"></tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' />
</td>
<td>
<asp:Label ID="GroupNameLabel" runat="server" Text='<%# Eval("GroupName") %>' />
</td>
</tr>
</ItemTemplate>
</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="DepartmentsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT Name, GroupName FROM HumanResources.Department" >
</asp:SqlDataSource>
</form>
</body>
</html>
Comentários
Use a PagedControlID propriedade para especificar o ID do controle que contém os dados que serão paginado pelo DataPager controle. O controle especificado deve implementar a IPageableItemContainer interface e deve usar o mesmo contêiner de nomenclatura que o DataPager controle. Um exemplo de um controle que você pode especificar é o ListView controle .
Se essa propriedade for uma cadeia de caracteres vazia ou null, o DataPager controle verificará se seu controle de contêiner implementa a IPageableItemContainer interface. Por exemplo, no ListView controle , a PagedControlID propriedade não precisará ser definida se você colocar o DataPager controle dentro do ListView.LayoutTemplate modelo. Isso ocorre porque o DataPager controle pode localizar automaticamente o ListView controle examinando a árvore de controle.
O valor dessa propriedade é armazenado no estado de exibição.
