DataPager.QueryStringField プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クエリ文字列フィールドの名前を取得または設定します。
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, setPublic Property QueryStringField As Stringプロパティ値
クエリ文字列フィールドの名前。 既定値は空の文字列です。DataPager コントロールでのページの移動に HTTP POST コマンドが使用されることを示します。
- 属性
-
WebCategoryAttribute
例
次の例は、クエリ文字列を使用してページ内を QueryStringField 移動するために、コントロール内 DataPager のプロパティを宣言によって設定する方法を示しています。 この例には、1 つのコントロールによって表示されるデータをページングするために使用される 2 つのDataPagerListViewコントロールが含まれています。
<%@ 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>
注釈
このプロパティを QueryStringField 使用して、コントロールが DataPager HTTP GET コマンドを使用してページ内を移動するように指定します。 GET 要求では、名前と値のペアで構成されるクエリ文字列フィールドがページの URL に追加されます。 この名前は、プロパティを使用して設定されます QueryStringField 。 値は、対応するページ番号です。 空の文字列またはnull空の場合QueryStringField、コントロールは HTTP POST コマンドを使用してページ内を移動します。
このプロパティを設定すると、データのすべてのページを検索エンジンによってインデックス付けする場合に便利です。 これは、コントロールがデータのページごとに異なる URL を生成するためです。
プロパティを QueryStringField 設定すると、次の条件が適用される場合があります。
1 つの DataPager ページに複数のコントロールがあり、同じデータ バインド コントロールを参照しています。 その場合は、これらのDataPagerコントロールのプロパティがQueryStringField同じ値に設定されていることを確認します。
1 つの DataPager ページに複数のコントロールがあり、異なるデータ バインド コントロールを参照しています。 その場合は、これらのDataPagerコントロールのプロパティがQueryStringField異なる値に設定されていることを確認します。 コントロールを DataPager 同じ値に設定すると、関連付けられているデータ バインド コントロールは、同じクエリ文字列フィールドを使用するため、同時にページ分割されます。
前のガイドラインに従わないと、予期しないページング動作が発生する可能性があります。 ただし、コントロールによって例外はスローされません。
プロパティが空の文字列でない場合 QueryStringField 、または nullオブジェクトのプロパティの ButtonType NumericPagerField NextPreviousPagerField 値は無視されます。 その場合、これらのオブジェクトはコントロールを HyperLink 使用してナビゲーション ボタンを作成します。