DataPager.QueryStringField 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.
Obtém ou define o nome do campo da cadeia de consulta.
public:
property System::String ^ QueryStringField { System::String ^ get(); void set(System::String ^ value); };[System.Web.WebCategory("Paging")]
public string QueryStringField { get; set; }[<System.Web.WebCategory("Paging")>]
member this.QueryStringField : string with get, setPublic Property QueryStringField As StringValor da propriedade
O nome do campo da cadeia de consulta. O padrão é uma cadeia de caracteres vazia, que indica que o controle DataPager usará um comando HTTP POST para navegar pelas páginas.
- Atributos
-
WebCategoryAttribute
Exemplos
O exemplo a seguir mostra como definir declarativamente a QueryStringField propriedade em um DataPager controle para navegar pelas páginas usando uma cadeia de caracteres de consulta. Este exemplo contém dois DataPager controles que são usados para usar a página por meio dos dados exibidos por um único 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 Example</title>
<style type="text/css">
th
{
background-color:#eef4fa;
border-top:solid 1px #9dbbcc;
border-bottom:solid 1px #9dbbcc;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>DataPager QueryStringField Example</h3>
<asp:DataPager runat="server" ID="DataPager1"
PagedControlID="CountriesListView"
QueryStringField="pageNumber">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
<br /><br />
<asp:ListView ID="CountriesListView"
DataSourceID="CountryDataSource"
runat="server" >
<LayoutTemplate>
<table cellpadding="4" width="500" runat="server" id="tblCountries">
<tr runat="server">
<th runat="server">Code</th>
<th runat="server">Name</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
</LayoutTemplate>
<ItemTemplate>
<tr>
<td>
<asp:Label ID="CountryCodeLabel" runat="server"
Text='<%# Eval("CountryRegionCode")%>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server"
Text='<%# Eval("Name")%>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<br />
<!-- The second DataPager control. -->
<asp:DataPager runat="server" ID="DataPager2"
PagedControlID="CountriesListView"
QueryStringField="pageNumber">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
<!-- 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="CountryDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [CountryRegionCode], [Name]
FROM [Person].[CountryRegion]">
</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 Example</title>
<style type="text/css">
th
{
background-color:#eef4fa;
border-top:solid 1px #9dbbcc;
border-bottom:solid 1px #9dbbcc;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>DataPager QueryStringField Example</h3>
<asp:DataPager runat="server" ID="DataPager1"
PagedControlID="CountriesListView"
QueryStringField="pageNumber">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
<br /><br />
<asp:ListView ID="CountriesListView"
DataSourceID="CountryDataSource"
runat="server" >
<LayoutTemplate>
<table cellpadding="4" width="500" runat="server" id="tblCountries">
<tr runat="server">
<th runat="server">Code</th>
<th runat="server">Name</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
</LayoutTemplate>
<ItemTemplate>
<tr>
<td>
<asp:Label ID="CountryCodeLabel" runat="server"
Text='<%# Eval("CountryRegionCode")%>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server"
Text='<%# Eval("Name")%>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<br />
<!-- The second DataPager control. -->
<asp:DataPager runat="server" ID="DataPager2"
PagedControlID="CountriesListView"
QueryStringField="pageNumber">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
<!-- 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="CountryDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [CountryRegionCode], [Name]
FROM [Person].[CountryRegion]">
</asp:SqlDataSource>
</form>
</body>
</html>
Comentários
Use a QueryStringField propriedade para especificar que o DataPager controle usa um comando HTTP GET para navegar pelas páginas. Em solicitações GET, um campo de cadeia de caracteres de consulta que consiste em um par nome/valor é adicionado à URL da página. O nome é definido usando a QueryStringField propriedade. O valor é o número da página correspondente. Se QueryStringField for uma cadeia de caracteres vazia ou null, o controle usará um comando HTTP POST para navegar pelas páginas.
Definir essa propriedade será útil se você quiser ter todas as páginas de dados indexadas por um mecanismo de pesquisa. Isso ocorre porque o controle produz uma URL diferente para cada página de dados.
Quando você define a QueryStringField propriedade, as seguintes condições podem ser aplicadas:
Você tem mais de um DataPager controle em uma página e eles fazem referência ao mesmo controle associado a dados. Nesse caso, verifique se a QueryStringField propriedade desses DataPager controles está definida como o mesmo valor.
Você tem mais de um DataPager controle em uma página e eles fazem referência a diferentes controles associados a dados. Nesse caso, verifique se a QueryStringField propriedade desses DataPager controles está definida como valores diferentes. Se você definir os DataPager controles com o mesmo valor, os controles associados ao limite de dados serão paginados ao mesmo tempo, pois eles usarão o mesmo campo de cadeia de caracteres de consulta.
Se você não seguir as diretrizes anteriores, poderá ocorrer um comportamento de paginação inesperado. No entanto, nenhuma exceção será gerada pelo controle.
Se QueryStringField a propriedade não for uma cadeia de caracteres vazia ou nullo valor da ButtonType propriedade ou NextPreviousPagerField objetos NumericPagerField será ignorado. Nesse caso, esses objetos usam o HyperLink controle para criar seus botões de navegação.