DataPager.QueryStringField Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

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.

Ruft den Namen des Abfragezeichenfolgenfelds ab oder legt diesen fest.

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, set

Public Property QueryStringField As String

Eigenschaftswert

String

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.

Attribute: WebCategoryAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie die QueryStringField Eigenschaft in einem DataPager Steuerelement deklarativ festlegen, 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 ein Abfragezeichenfolgenfeld, das aus einem Namen-Wert-Paar besteht, der URL der Seite hinzugefügt. Der Name wird mithilfe der QueryStringField Eigenschaft festgelegt. Der Wert ist die entsprechende Seitenzahl. Wenn QueryStringField es sich um eine leere Zeichenfolge oder nullhandelt, verwendet das Steuerelement einen HTTP POST-Befehl, 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 eine andere URL für jede Datenseite erzeugt.

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

Sie verfügen über DataPager mehrere 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 DataPager mehrere 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 Steuerelemente auf denselben Wert festlegen, werden die DataPager zugeordneten datengebundenen Steuerelemente gleichzeitig paginiert, da sie dasselbe Abfragezeichenfolgenfeld verwenden.

Wenn Sie die vorherigen Richtlinien nicht befolgen, können unerwartetes Pagingverhalten auftreten. Es wird jedoch keine Ausnahme vom Steuerelement ausgelöst.

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

Gilt für