DataPager.QueryStringField Eigenschaft

Definition

Ruft den Namen des Abfragezeichenfolgenfelds ab oder legt diesen fest.

public:
 property System::String ^ QueryStringField { System::String ^ get(); void set(System::String ^ value); };
public string QueryStringField { get; set; }
member this.QueryStringField : string with get, set
Public Property QueryStringField As String

Eigenschaftswert

Der Name des Abfragezeichenfolgenfelds. Der Standardwert ist eine leere Zeichenfolge und gibt an, dass das DataPager-Steuerelement mit einem HTTP POST-Befehl durch die Seiten navigiert.

Beispiele

Im folgenden Beispiel wird gezeigt, 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 Name-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 oder handelt null, verwendet das Steuerelement einen HTTP POST-Befehl, um durch die Seiten zu navigieren.

Das Festlegen dieser Eigenschaft ist nützlich, wenn Sie alle Datenseiten von einer Suchmaschine indiziert haben möchten. Dies tritt auf, weil das Steuerelement eine andere URL für jede Datenseite erzeugt.

Wenn Sie die QueryStringField -Eigenschaft festlegen, gelten möglicherweise die folgenden Bedingungen:

  • Sie verfügen über mehrere DataPager Steuerelemente auf einer Seite, die auf dasselbe datengebundene Steuerelement verweisen. 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, die auf verschiedene datengebundene Steuerelemente verweisen. 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 die vorherigen Richtlinien nicht befolgen, kann unerwartetes Pagingverhalten auftreten. Das Steuerelement löst jedoch keine Ausnahme aus.

Wenn QueryStringField die Eigenschaft keine leere Zeichenfolge oder nullist, wird der Wert der ButtonType Eigenschaft von NumericPagerField oder NextPreviousPagerField -Objekten ignoriert. In diesem Fall verwenden diese Objekte das HyperLink -Steuerelement, um ihre Navigationsschaltflächen zu erstellen.

Gilt für:

Weitere Informationen