DataPager.QueryStringField Eigenschaft

Definition

Ruft den Namen des Abfragezeichenfolgenfelds ab oder legt diesen fest.Gets or sets the name of the query string field.

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

Eigenschaftswert

Der Name des Abfragezeichenfolgenfelds.The name of the query string field. Der Standardwert ist eine leere Zeichenfolge und gibt an, dass das DataPager-Steuerelement mit einem HTTP POST-Befehl durch die Seiten navigiert.The default is an empty string, which indicates that the DataPager control will use a HTTP POST command to navigate through the pages.

Attribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie die QueryStringField-Eigenschaft in einem DataPager-Steuerelement deklarativ festgelegt wird, um durch die Seiten zu navigieren, indem eine Abfrage Zeichenfolge verwendet wird.The following example shows how to declaratively set the QueryStringField property in a DataPager control in order to navigate through the pages by using a query string. Dieses Beispiel enthält zwei DataPager-Steuerelemente, die verwendet werden, um die Daten zu durchsuchen, die von einem einzelnen ListView Steuerelement angezeigt werden.This example contains two DataPager controls that are used to page through the data that is displayed by a single ListView control.

<%@ 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.Use the QueryStringField property to specify that the DataPager control uses an HTTP GET command to navigate through the pages. In Get-Anforderungen wird der URL der Seite ein Feld aus einer Abfrage Zeichenfolge hinzugefügt, das aus einem Name/Wert-Paar besteht.In GET requests, a query string field that consists of a name/value pair is added to the URL of the page. Der Name wird mit der QueryStringField-Eigenschaft festgelegt.The name is set by using the QueryStringField property. Der Wert ist die entsprechende Seitenzahl.The value is the corresponding page number. Wenn QueryStringField eine leere Zeichenfolge oder nullist, verwendet das Steuerelement einen HTTP POST-Befehl, um durch die Seiten zu navigieren.If QueryStringField is an empty string or null, the control uses an HTTP POST command to navigate through the pages.

Das Festlegen dieser Eigenschaft ist nützlich, wenn alle Datenseiten von einer Suchmaschine indiziert werden sollen.Setting this property is useful if you want to have all the pages of data indexed by a search engine. Dies liegt daran, dass das-Steuerelement für jede Datenseite eine andere URL erzeugt.This occurs because the control produces a different URL for each page of data.

Wenn Sie die QueryStringField-Eigenschaft festlegen, können die folgenden Bedingungen zutreffen:When you set the QueryStringField property, the following conditions might apply:

  • Sie verfügen über mehr als ein DataPager Steuerelement auf einer Seite und verweisen auf dasselbe Daten gebundene Steuerelement.You have more than one DataPager control in a page and they reference the same data-bound control. Stellen Sie in diesem Fall sicher, dass die QueryStringField-Eigenschaft dieser DataPager Steuerelemente auf denselben Wert festgelegt ist.In that case, make sure that the QueryStringField property of these DataPager controls is set to the same value.

  • Sie verfügen über mehr als ein DataPager-Steuerelement auf einer Seite und verweisen auf verschiedene Daten gebundene Steuerelemente.You have more than one DataPager control in a page and they reference different data-bound controls. Stellen Sie in diesem Fall sicher, dass die QueryStringField-Eigenschaft dieser DataPager Steuerelemente auf unterschiedliche Werte festgelegt ist.In that case, make sure that the QueryStringField property of these DataPager controls is set to different values. Wenn Sie die DataPager-Steuerelemente auf denselben Wert festlegen, werden die zugeordneten Daten gebundenen Steuerelemente gleichzeitig paginiert, da Sie das gleiche Abfrage Zeichen folgen Feld verwenden.If you set the DataPager controls to the same value, the associated data-bound controls will be paginated at the same time, because they will use the same query-string field.

Wenn Sie die vorherigen Richtlinien nicht befolgen, kann unerwartetes Pagingverhalten auftreten.If you do not follow the previous guidelines, unexpected paging behavior can occur. Vom Steuerelement wird jedoch keine Ausnahme ausgelöst.However, no exception will be thrown by the control.

Wenn QueryStringField Eigenschaft keine leere Zeichenfolge oder nullist, wird der Wert der Eigenschaft ButtonType von NumericPagerField-oder NextPreviousPagerField Objekten ignoriert.If QueryStringField property is not an empty string or null, the value of the ButtonType property of NumericPagerField or NextPreviousPagerField objects is ignored. In diesem Fall verwenden diese Objekte das HyperLink-Steuerelement, um Ihre Navigations Schaltflächen zu erstellen.In that case, these objects use the HyperLink control to create their navigation buttons.

Gilt für:

Siehe auch