DataPager.QueryStringField Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví název pole řetězce dotazu.

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

Hodnota vlastnosti

String

Název pole řetězce dotazu. Výchozí hodnota je prázdný řetězec, který označuje, že DataPager ovládací prvek použije příkaz HTTP POST k procházení stránek.

Atributy: WebCategoryAttribute

Příklady

Následující příklad ukazuje, jak deklarativní nastavit QueryStringField vlastnost v ovládacím DataPager prvku pro procházení stránek pomocí řetězce dotazu. Tento příklad obsahuje dva DataPager ovládací prvky, které se používají ke stránkování dat zobrazených jedním ListView ovládacím prvku.

<%@ 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>

Poznámky

QueryStringField Pomocí vlastnosti určete, že DataPager ovládací prvek používá příkaz HTTP GET k procházení stránek. V požadavcích GET se do adresy URL stránky přidá pole řetězce dotazu, které se skládá z páru name/value. Název je nastaven pomocí QueryStringField vlastnosti. Hodnota je odpovídající číslo stránky. Pokud QueryStringField je prázdný řetězec nebo null, ovládací prvek používá příkaz HTTP POST k procházení stránek.

Nastavení této vlastnosti je užitečné, pokud chcete mít všechny stránky dat indexované vyhledávacím webem. K tomu dochází, protože ovládací prvek vytvoří jinou adresu URL pro každou stránku dat.

Při nastavování QueryStringField vlastnosti se můžou použít následující podmínky:

Na stránce máte více ovládacích DataPager prvků a odkazují na stejný ovládací prvek vázaný na data. V takovém případě se ujistěte, že QueryStringField vlastnost těchto DataPager ovládacích prvků je nastavena na stejnou hodnotu.
Na stránce máte více ovládacích DataPager prvků a odkazují na různé ovládací prvky vázané na data. V takovém případě se ujistěte, že QueryStringField vlastnost těchto DataPager ovládacích prvků je nastavena na různé hodnoty. Pokud nastavíte DataPager ovládací prvky na stejnou hodnotu, přidružené ovládací prvky vázané na data budou stránkovány současně, protože budou používat stejné pole řetězce dotazu.

Pokud nedodržujete předchozí pokyny, může dojít k neočekávanému chování stránkování. Ovládací prvek ale nevyvolá žádnou výjimku.

Pokud QueryStringField vlastnost není prázdný řetězec nebo null, hodnota ButtonType vlastnosti NumericPagerField nebo NextPreviousPagerField objekty je ignorována. V takovém případě tyto objekty používají HyperLink ovládací prvek k vytvoření navigačních tlačítek.

Platí pro