Sdílet prostřednictvím

DataPager.QueryStringField Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.Extensions.dll

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

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

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 bude k procházení stránek používat příkaz HTTP POST.

Příklady

Následující příklad ukazuje, jak deklarativně nastavit QueryStringField vlastnost v ovládacím DataPager prvku, aby bylo možné procházet stránky pomocí řetězce dotazu. Tento příklad obsahuje dva DataPager ovládací prvky, které se používají k procházení 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á k procházení stránek příkaz HTTP GET. V požadavcích GET se do adresy URL stránky přidá pole řetězce dotazu, které se skládá z dvojice název/hodnota. Název se nastaví 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á k procházení stránek příkaz HTTP POST.

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

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

  • Na stránce máte více než jeden DataPager ovládací prvek, který odkazuje na stejný ovládací prvek vázaný na data. V takovém případě se ujistěte, že QueryStringField je vlastnost těchto DataPager ovládacích prvků nastavená na stejnou hodnotu.

  • Na stránce máte více než jeden DataPager ovládací prvek, který odkazuje na různé ovládací prvky vázané na data. V takovém případě se ujistěte, že QueryStringField je vlastnost těchto DataPager ovládacích prvků nastavená na jiné hodnoty. Pokud ovládací prvky nastavíte DataPager na stejnou hodnotu, budou přidružené ovládací prvky vázané na data 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 však nevyvolá žádnou výjimku.

Pokud QueryStringField vlastnost není prázdný řetězec nebo null, hodnota ButtonType vlastnosti objektu NumericPagerField nebo NextPreviousPagerField 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

Viz také