DataPager.QueryStringField Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Namens des Abfragezeichenfolgenfelds.
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 StringEigenschaftswert
Der Name des Abfragezeichenfolgenfelds. Der Standardwert ist eine leere Zeichenfolge, die angibt, dass das DataPager Steuerelement einen HTTP POST-Befehl verwendet, um durch die Seiten zu navigieren.
Beispiele
Das folgende Beispiel zeigt, wie Die QueryStringField Eigenschaft in einem DataPager Steuerelement deklarativ festgelegt wird, um mithilfe einer Abfragezeichenfolge durch die Seiten zu navigieren. Dieses Beispiel enthält zwei DataPager Steuerelemente, die verwendet werden, um die Daten zu durchlaufen, die von einem einzelnen ListView Steuerelement angezeigt werden.
<%@ 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>
Hinweise
Verwenden Sie die QueryStringField Eigenschaft, um anzugeben, dass das DataPager Steuerelement einen HTTP GET-Befehl verwendet, um durch die Seiten zu navigieren. In GET-Anforderungen wird der URL der Seite ein Abfragezeichenfolgenfeld hinzugefügt, das aus einem Namen-Wert-Paar besteht. Der Name wird mithilfe der QueryStringField Eigenschaft festgelegt. Der Wert ist die entsprechende Seitenzahl. Wenn QueryStringField es sich um eine leere Zeichenfolge handelt oder nulldas Steuerelement einen HTTP POST-Befehl verwendet, um durch die Seiten zu navigieren.
Das Festlegen dieser Eigenschaft ist nützlich, wenn Sie alle Seiten von Daten indiziert haben möchten, die von einer Suchmaschine indiziert werden. Dies tritt auf, da das Steuerelement für jede Datenseite eine andere URL erzeugt.
Wenn Sie die QueryStringField Eigenschaft festlegen, können die folgenden Bedingungen gelten:
Sie verfügen über mehrere DataPager Steuerelemente auf einer Seite und verweisen auf dasselbe datengebundene Steuerelement. Stellen Sie in diesem Fall sicher, dass die QueryStringField Eigenschaft dieser DataPager Steuerelemente auf denselben Wert festgelegt ist.
Sie verfügen über mehrere DataPager Steuerelemente auf einer Seite und verweisen auf unterschiedliche datengebundene Steuerelemente. Stellen Sie in diesem Fall sicher, dass die QueryStringField Eigenschaft dieser DataPager Steuerelemente auf unterschiedliche Werte festgelegt ist. Wenn Sie die DataPager Steuerelemente auf denselben Wert festlegen, werden die zugeordneten datengebundenen Steuerelemente gleichzeitig paginiert, da sie dasselbe Abfragezeichenfolgenfeld verwenden.
Wenn Sie den vorherigen Richtlinien nicht folgen, können unerwartetes Pagingverhalten auftreten. Es wird jedoch keine Ausnahme durch das Steuerelement ausgelöst.
Wenn QueryStringField die Eigenschaft keine leere Zeichenfolge ist oder nullder Wert der Eigenschaft NumericPagerField oder NextPreviousPagerField der ButtonType Objekte ignoriert wird. In diesem Fall verwenden diese Objekte das HyperLink Steuerelement, um ihre Navigationsschaltflächen zu erstellen.
