DynamicRouteExpression Класс

Определение

Пространство имен:: System.Web.DynamicData

Сборка:: System.Web.DynamicData.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Получает первичный ключ из сведений о маршрутизации, чтобы выполнять фильтрацию данных.

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

Примеры

В следующем примере показан пользовательский шаблон страницы List.aspx для таблицы Products. Он использует ColumnName свойство для указания внешнего ключа ProductCategory для фильтрации строк Products.

На пользовательской странице List.aspx отображается столбец, содержащий ссылки категорий, содержащихся в столбце ProductCategory внешнего ключа. Когда пользователь щелкает одну из этих ссылок, страница List.aspx отображает только строки, содержащие выбранную категорию.

В примере требуется следующее:

Веб-сайт динамических данных. Дополнительные сведения см. в пошаговом руководстве. Создание нового веб-сайта динамических данных с помощью шаблонов.
Пример базы данных AdventureWorksLT.

<%@ 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 получает первичный ключ из сведений о маршрутизации, содержащихся в веб-запросе. Затем элемент 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)	Задает контекст HTTP объекта DynamicRouteExpression .
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)

Применяется к

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы: