DataPager.QueryStringField Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de naam van het querytekenreeksveld op of stelt u deze in.
public:
property System::String ^ QueryStringField { System::String ^ get(); void set(System::String ^ value); };public string QueryStringField { get; set; }member this.QueryStringField : string with get, setPublic Property QueryStringField As StringWaarde van eigenschap
De naam van het querytekenreeksveld. De standaardwaarde is een lege tekenreeks, die aangeeft dat het DataPager besturingselement een HTTP POST-opdracht gebruikt om door de pagina's te navigeren.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de QueryStringField eigenschap declaratief instelt in een DataPager besturingselement om door de pagina's te navigeren met behulp van een queryreeks. Dit voorbeeld bevat twee DataPager besturingselementen die worden gebruikt om door de gegevens te bladeren die door één ListView besturingselement worden weergegeven.
<%@ 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>
Opmerkingen
Gebruik de QueryStringField eigenschap om op te geven dat het DataPager besturingselement een HTTP GET-opdracht gebruikt om door de pagina's te navigeren. In GET-aanvragen wordt een querytekenreeksveld dat bestaat uit een naam/waardepaar toegevoegd aan de URL van de pagina. De naam wordt ingesteld met behulp van de QueryStringField eigenschap. De waarde is het bijbehorende paginanummer. Als QueryStringField dit een lege tekenreeks is of null, gebruikt het besturingselement een HTTP POST-opdracht om door de pagina's te navigeren.
Het instellen van deze eigenschap is handig als u alle pagina's met gegevens wilt laten indexeren door een zoekmachine. Dit komt doordat het besturingselement een andere URL produceert voor elke pagina met gegevens.
Wanneer u de QueryStringField eigenschap instelt, kunnen de volgende voorwaarden van toepassing zijn:
U hebt meer dan één DataPager besturingselement op een pagina en ze verwijzen naar hetzelfde gegevensgebonden besturingselement. Zorg er in dat geval voor dat de QueryStringField eigenschap van deze DataPager besturingselementen is ingesteld op dezelfde waarde.
U hebt meer dan één DataPager besturingselement op een pagina en ze verwijzen naar verschillende besturingselementen voor gegevens. Zorg er in dat geval voor dat de QueryStringField eigenschap van deze DataPager besturingselementen is ingesteld op verschillende waarden. Als u de DataPager besturingselementen instelt op dezelfde waarde, worden de gekoppelde gegevensgebonden besturingselementen tegelijkertijd gepagineerd, omdat ze hetzelfde querytekenreeksveld gebruiken.
Als u niet aan de vorige richtlijnen voldoet, kan onverwacht pagingsgedrag optreden. Er wordt echter geen uitzondering gegenereerd door het besturingselement.
Als QueryStringField de eigenschap geen lege tekenreeks is of nullals de waarde van de ButtonType eigenschap van NumericPagerField of NextPreviousPagerField objecten wordt genegeerd. In dat geval gebruiken deze objecten het HyperLink besturingselement om hun navigatieknoppen te maken.
