DynamicRouteExpression 類別

參考

定義

命名空間:: System.Web.DynamicData

組件:: System.Web.DynamicData.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從路由資訊取得主索引鍵，以執行資料篩選。

public ref class DynamicRouteExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression

public class DynamicRouteExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression

type DynamicRouteExpression = class
    inherit DataSourceExpression

Public Class DynamicRouteExpression
Inherits DataSourceExpression

繼承: Object

DataSourceExpression
DynamicRouteExpression

範例

具有原始程式碼的Visual Studio專案隨附于本主題：Scaffolding 動態資料。

下列範例顯示 Products 資料表的自訂 List.aspx 頁面範本。它會使用 ColumnName 屬性來指定 ProductCategory 外鍵來篩選 Products 資料列。

自訂 List.aspx 頁面會顯示包含 ProductCategory 外鍵資料行所包含類別連結的資料行。當使用者按一下其中一個連結時，List.aspx 頁面只會顯示包含所選類別的資料列。

此範例需要下列專案：

動態資料網站。如需詳細資訊，請參閱逐步解說：使用 Scaffolding 建立新的動態資料網站。
AdventureWorksLT 範例資料庫。如需詳細資訊，請參閱如何：使用連線至 AdventureWorksLT 資料庫。MDF 檔案。

<%@ Page Language="C#" MasterPageFile="~/Site.master" CodeFile="List.aspx.cs" Inherits="List" %>

<%@ Register src="~/DynamicData/Content/GridViewPager.ascx" tagname="GridViewPager" tagprefix="asp" %>

<asp:Content ID="headContent" ContentPlaceHolderID="head" Runat="Server">
</asp:Content>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">
    <asp:DynamicDataManager ID="DynamicDataManager1" runat="server" AutoLoadForeignKeys="true">
        <DataControls>
            <asp:DataControlReference ControlID="GridView1" />
        </DataControls>
    </asp:DynamicDataManager>

   
    <h2 class="DDSubHeader">Using DynamicRouteExpression with <%= table.DisplayName%> table</h2>

    <asp:UpdatePanel ID="UpdatePanel1" runat="server">
        <ContentTemplate>
            <div class="DD">
                <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true"
                    HeaderText="List of validation errors" CssClass="DDValidator" />
                <asp:DynamicValidator runat="server" ID="GridViewValidator" ControlToValidate="GridView1" Display="None" CssClass="DDValidator" />
                <br /> <br />
          
                <div class="DDFilter"> 
                    <asp:HyperLink runat="server" ID="ViewAllLink" Text="View All Categories" />
                </div>
            
            </div>

            <asp:GridView ID="GridView1" runat="server" DataSourceID="GridDataSource" EnablePersistedSelection="true"
                AllowPaging="True" AllowSorting="True" CssClass="DDGridView"
                RowStyle-CssClass="td" HeaderStyle-CssClass="th" CellPadding="6">
                <Columns>
                    <asp:TemplateField>
                        <ItemTemplate>
                            <asp:DynamicHyperLink runat="server" Action="Edit" Text="Edit"
                            /> <asp:LinkButton runat="server" CommandName="Delete" Text="Delete"
                                OnClientClick='return confirm("Are you sure you want to delete this item?");'
                            /> <asp:DynamicHyperLink runat="server" Text="Details" />
                            <!-- Create action link to filter items that
                            belong to the same category -->
                             <a ID="CategoryRouteID" runat="server" 
                                    href='<%# GetRouteInformation() %>'>
                                Filter By: <%# GetProductCategory() %>
                            </a>
                        </ItemTemplate>
                    </asp:TemplateField>
                </Columns>

                <PagerStyle CssClass="DDFooter"/>        
                <PagerTemplate>
                    <asp:GridViewPager runat="server" />
                </PagerTemplate>
                <EmptyDataTemplate>
                    There are currently no items in this table.
                </EmptyDataTemplate>
            </asp:GridView>

            <asp:LinqDataSource ID="GridDataSource" runat="server" EnableDelete="true" />
            
            <asp:QueryExtender TargetControlID="GridDataSource" ID="GridQueryExtender" runat="server">
                <asp:DynamicRouteExpression ColumnName="ProductCategory" />
            </asp:QueryExtender>

            <br />

            <div class="DDBottomHyperLink">
                <asp:DynamicHyperLink ID="InsertHyperLink" runat="server" Action="Insert"><img runat="server" src="~/DynamicData/Content/Images/plus.gif" alt="Insert new item" />Insert new item</asp:DynamicHyperLink>
            </div>
        </ContentTemplate>
    </asp:UpdatePanel>
</asp:Content>

<%@ Page Language="VB" MasterPageFile="~/Site.master" CodeFile="List.aspx.vb" Inherits="List" %>

<%@ Register src="~/DynamicData/Content/GridViewPager.ascx" tagname="GridViewPager" tagprefix="asp" %>

<asp:Content ID="headContent" ContentPlaceHolderID="head" Runat="Server">
</asp:Content>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">
    <asp:DynamicDataManager ID="DynamicDataManager1" runat="server" AutoLoadForeignKeys="true">
        <DataControls>
            <asp:DataControlReference ControlID="GridView1" />
        </DataControls>
    </asp:DynamicDataManager>

    <h2 class="DDSubHeader"><%= table.DisplayName%></h2>

    <asp:UpdatePanel ID="UpdatePanel1" runat="server">
        <ContentTemplate>
            <div class="DD">
                <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true"
                    HeaderText="List of validation errors" CssClass="DDValidator" />
                <asp:DynamicValidator runat="server" ID="GridViewValidator" ControlToValidate="GridView1" Display="None" CssClass="DDValidator" />
            </div>

            <asp:GridView ID="GridView1" runat="server" DataSourceID="GridDataSource" EnablePersistedSelection="true"
                AllowPaging="True" AllowSorting="True" CssClass="DDGridView"
                RowStyle-CssClass="td" HeaderStyle-CssClass="th" CellPadding="6">
                <Columns>
                    <asp:TemplateField>
                        <ItemTemplate>
                            <asp:DynamicHyperLink runat="server" Action="Edit" Text="Edit"
                            /> <asp:LinkButton runat="server" CommandName="Delete" Text="Delete"
                                OnClientClick='return confirm("Are you sure you want to delete this item?");'
                            /> <asp:DynamicHyperLink runat="server" Text="Details" />
                        
                            <!-- Create action link to filter items that
                            belong to the same category -->
                             <a ID="CategoryRouteID" runat="server" 
                                    href='<%# GetRouteInformation() %>'>
                                Filter By: <%# GetProductCategory() %>
                            </a>
                        </ItemTemplate>
                    </asp:TemplateField>
                </Columns>

                <PagerStyle CssClass="DDFooter"/>        
                <PagerTemplate>
                    <asp:GridViewPager runat="server" />
                </PagerTemplate>
                <EmptyDataTemplate>
                    There are currently no items in this table.
                </EmptyDataTemplate>
            </asp:GridView>

            <asp:LinqDataSource ID="GridDataSource" runat="server" EnableDelete="true" />
            
            <!-- Set the foreign-key to use for filtering -->
            <asp:QueryExtender TargetControlID="GridDataSource" ID="GridQueryExtender" runat="server">
                <asp:DynamicRouteExpression ColumnName="ProductCategory" />
            </asp:QueryExtender>

            <br />

            <div class="DDBottomHyperLink">
                <asp:DynamicHyperLink ID="InsertHyperLink" runat="server" Action="Insert"><img runat="server" src="~/DynamicData/Content/Images/plus.gif" alt="Insert new item" />Insert new item</asp:DynamicHyperLink>
            </div>
        </ContentTemplate>
    </asp:UpdatePanel>
</asp:Content>

// Create route information based on the
// foreign-key specified in the 
// DynamicRouteExpression page markup. 
protected string GetRouteInformation()
{

    // Retrieve the current data item.
    var productItem = (Product)GetDataItem();

    if (productItem != null)
    {

        RouteValueDictionary rvd = new RouteValueDictionary();
        rvd.Add("ProductCategoryID", productItem.ProductCategoryID );

        string routePath =
            table.GetActionPath(PageAction.List, rvd);

        return routePath;
    }

    return string.Empty;
}

// Get the name of the foreign-key category. 
protected string GetProductCategory()
{
    // Retrieves the current data item.
    var productItem = (Product)GetDataItem();

    if (productItem != null)
    {
        return productItem.ProductCategory.Name;
    }
    return string.Empty;
}

' Create route information based on the
' foreign-key specified in the 
' DynamicRouteExpression page markup. 
Protected Function GetRouteInformation() As String

    ' Retrieve the current data item.
    Dim productItem = CType(GetDataItem(), Product)

    If productItem IsNot Nothing Then

        Dim rvd As New RouteValueDictionary()
        rvd.Add("ProductCategoryID", productItem.ProductCategoryID)

        Dim routePath As String = table.GetActionPath(PageAction.List, rvd)

        Return routePath

    End If

    Return String.Empty
End Function

' Get the name of the foreign-key category. 
Protected Function GetProductCategory() As String
    ' Retrieves the current data item.
    Dim productItem = CType(GetDataItem(), Product)

    If productItem IsNot Nothing Then
        Return productItem.ProductCategory.Name
    End If
    Return String.Empty
End Function

備註

類別 DynamicRouteExpression 會與頁面標記中的控制項搭配 QueryExtender 使用。類別 DynamicRouteExpression 會從 Web 要求中包含的路由資訊取得主鍵。控制項 QueryExtender 接著會使用子句中的 Where 索引鍵。這會修改資料來源的查詢，然後傳回索引鍵篩選的資料表資料列。

您也可以使用使用屬性指定的 ColumnName 外鍵來篩選資料。

宣告式語法

<asp:DynamicRouteExpression  
  ColumnName="Name of the foreign key column"/>

建構函式

DynamicRouteExpression()

初始化 DynamicRouteExpression 類別的新執行個體。

屬性

ColumnName	取得或設定資料行的名稱，這個資料行包含用來查詢資料來源的外部索引鍵。
Context	取得擁有者控制項的 HttpContext 執行個體。 (繼承來源 DataSourceExpression)
DataSource	取得與擁有者控制項相關聯的資料來源物件。 (繼承來源 DataSourceExpression)
IsTrackingViewState	取得值，這個值指出資料來源運算式物件是否正在追蹤其檢視狀態變更。 (繼承來源 DataSourceExpression)
Owner	取得擁有者控制項。 (繼承來源 DataSourceExpression)
ViewState	取得 StateBag 類別的執行個體，這個執行個體包含目前的檢視狀態資訊。 (繼承來源 DataSourceExpression)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetQueryable(IQueryable)	從資料來源取得查詢。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
LoadViewState(Object)	載入 DataSourceExpression 物件中必須保存的值狀態。 (繼承來源 DataSourceExpression)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SaveViewState()	儲存 DataSourceExpression 物件的目前檢視狀態。 (繼承來源 DataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource)	設定 DynamicRouteExpression 物件的 HTTP 內容。
SetDirty()	標記 DataSourceExpression 物件，以便將其狀態儲存在檢視狀態中。 (繼承來源 DataSourceExpression)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TrackViewState()	追蹤 DataSourceExpression 物件的檢視狀態變更，以便該變更可針對資料來源運算式物件儲存到 StateBag 物件中。 (繼承來源 DataSourceExpression)

明確介面實作

IStateManager.IsTrackingViewState	當由類別實作時取得值，這個值指出資料來源運算式物件是否正在追蹤其檢視狀態變更。 (繼承來源 DataSourceExpression)
IStateManager.LoadViewState(Object)	當由類別實作時，載入資料來源運算式物件先前儲存的檢視狀態。 (繼承來源 DataSourceExpression)
IStateManager.SaveViewState()	當類別實作時，儲存 DataSourceExpression 物件的目前檢視狀態。 (繼承來源 DataSourceExpression)
IStateManager.TrackViewState()	當由類別實作時，追蹤 DataSourceExpression 物件的檢視狀態變更，以便該變更可針對資料來源運算式物件儲存到 StateBag 物件中。 (繼承來源 DataSourceExpression)

適用於

共用方式為

DynamicRouteExpression 類別

定義

範例

備註

宣告式語法

建構函式

屬性

方法

明確介面實作

適用於

其他資源