[转载]一步步学会使用ASP.NET 4 WEB应用程序中使用URL Routing(翻译)

[转载]一步步学会使用ASP.NET 4 WEB应用程序中使用URL Routing(翻译) – longgel – 博客园.

创建路由


路由就是将URL路径映射到具体的物理文件。若要将路由添加到网站中, 请使用 RouteCollection.MapPageRoute 方法将它们添加到RouteTable类的静态Routes属性。

将 用于添加路由的方法添加到 Global.asax 文件中
  1. 如果网站还没有 Global.asax 文件,请通过执行下列步骤添加一个这样的文件:
    1. 右击“解决方案资源管理器”中的 Web 项目,然后选择“添加新项”。
    2. 选择“全局应用程序类”,再单击“添加”。
  2. 打开 Global.asax 文件。
  3. 在Application指令的后面,添加用于 System.Web.Routing命名空间的Import指令,如下面的示例所示:
    <%@ Import Namespace="System.Web.Routing" %>
    
  4. 在 Session_End方法的后面添加以下代码:
    void RegisterRoutes(RouteCollection routes)
    {
    }

    在下面的过程中,您将向此方法中添加用于创建路由的代码。

  5. 在 Application_Start 方法中,调用RegisterRoutes添加路由规则,如下面的示例所示:
void Application_Start(object sender, EventArgs e)
{
RegisterRoutes(RouteTable.Routes);
}

上面的过程添加了用于注册路由的空方法。现在,将使用此方法将路由添加到网站中。

添加路由
  1. 在 RegisterRoutes 方法中,添加以下代码:
    routes.MapPageRoute(“”,
    “SalesReportSummary/{year}”,
    “~/sales.aspx”);

    此代码添加了一个未命名的路由,该路由具有URL匹配模式,该模式包含文本值“SalesReportSummary”和名为year的占位符 (URL参数)。它将路由映射到名为 Sales.aspx 的文件。

  2. 在 RegisterRoutes 方法中,添加以下代码:
    routes.MapPageRoute(“SalesRoute”,
    “SalesReport/{locale}/{year}”,
    “~/sales.aspx”);

    此代码添加名为SalesRoute的路由。如果对路由规则进行了命名,那么在下面创建了相同的路由规则的时候,可以使用名称区分它们。

  3. 在 RegisterRoutes 方法中,添加以下代码:
    routes.MapPageRoute(“ExpensesRoute”,
    “ExpenseReport/{locale}/{year}/{*extrainfo}”,
    “~/expenses.aspx”, true,
    new RouteValueDictionary {
    { “locale”, “US” },
    { “year”, DateTime.Now.Year.ToString() } },
    new RouteValueDictionary {
    { “locale”, “[a-z]{2}” },
    { “year”, @”\d{4}” } });

    此 代码添加名为 ExpensesRoute 的路由。此路由包括一个普通匹配参数 extrainfo。此代码将 locale 参数的默认值设置为“US”,将 year 参数的默认值设置为今年。约束指定 locale 参数必须由两个字母字符组成year 参数必须由四个数字组成。

使用路由创建超链接


当向网页中添加超链接时,如果希望指定路由 URL 而不是物理文件,则您有两个选择:

  • 可以对路由URL进行硬编码。
  • 可以指定路由参数名称和值,并让 ASP.NET 生成对应的 URL。如有必要,还可以指定路由名称,以便唯一标识路由。如果稍后更改路由URL规则,则必须更新所有硬编码的URL,但是如果让 ASP.NET生成URL,则始终自动生成正确的URL(除非模式中的参数已更改)。

在下面的过程中,将使用硬编码 URL 的超链接添加到网页。

创建硬编码的 URL
  1. 在“Solution”中,右击 Web 项目,然后单击”Add Item”。

    显示”Add Item”对话框。

  2. 选择“Web 窗体”模板,确保选中“Place code in separate file”,将名称设置为“Links.aspx”,然后单击“添加”。

    即会在“源”视图中打开Links.aspx页。

  3. 在开始和结束 <div> 标记之间添加以下标记:
    <asp:HyperLink ID=”HyperLink1″ runat=”server”
    NavigateUrl
    =”~/salesreportsummary/2010″>
    Sales Report – All locales, 2010
    </asp:HyperLink>
    <br />
    <asp:HyperLink ID=”HyperLink2″ runat=”server”
    NavigateUrl
    =”~/salesreport/WA/2011″>
    Sales Report – WA, 2011
    </asp:HyperLink>
    <br />
    <asp:HyperLink ID=”HyperLink3″ runat=”server”
    NavigateUrl
    =”~/expensereport”>
    Expense Report – Default Locale and Year (US, current year)
    </asp:HyperLink>
    <br />

    此标记中使用硬编码URL创建三个HyperLink控件。第一个超链接匹配销售情况汇总路由的URL模式,第二个超链接匹配名为 SalesRoute 的路由,第三个超链接匹配名为ExpensesRoute 的路由。由于没有为第三个超链接的 URL 指定参数,为该路由定义的默认值将传递给Expenses.aspx。

接下来,将添加标记(这些标记创建用于指定路由参数和路由名称的超链接)以创建路由URL。

使用标记创建自动生成的URL
  • 在“源”视图中保持Links.aspx 打开,在上一过程中创建的HyperLink控件后添加以下代码:
    <asp:HyperLink ID=”HyperLink4″ runat=”server”
    NavigateUrl
    =”<%$RouteUrl:year=2011%>”>
    Sales Report – All locales, 2011
    </asp:HyperLink>
    <br />
    <asp:HyperLink ID=”HyperLink5″ runat=”server”
    NavigateUrl
    =”<%$RouteUrl:locale=CA,year=2009,routename=salesroute%>”>
    Sales Report – CA, 2009
    </asp:HyperLink>
    <br />

    此标记使用 RouteUrl 表达式创建名为SalesSummaryRoute和SalesRoute的URL。第二个 RouteUrl 表达式指定路由的名称,因为代码中提供的参数列表可以匹配 ExpensesRoute URL模式或 SalesRoute URL模式。ExpensesRoute URL 模式具有 SalesRoute URL模式所没有的 extrainfo 占位符,但是 extrainfo 是一个可用于放置各种信息的占位符,这意味着它是可选的。

在下面的过程中,将添加用于创建超链接的标记,并通过指定路由参数和路由名称,使用代码生成超链接的 URL。

使用代码创建自动生成的 URL
  1. 在“源”视图中保持 Links.aspx 打开,在上一过程中创建的 HyperLink控件后添加以下代码:
    <asp:HyperLink ID=”HyperLink6″ runat=”server”>
    Expense Report – CA, 2008
    </asp:HyperLink>
    <br />

    此标记不设置 NavigateUrl 属性,因为该属性将在代码运行时生成。

  2. 在“Solution”中,展开 Links.aspx,然后打开 或 Links.aspx.cs。
  3. 为 System.Web.Routing命名空间添加 using 语句,如下面的示例所示:
    using System.Web.Routing;
    
  4. 在Page_Load方法中,添加以下代码:
    
    

    此代码创建包含三个参数的 RouteValueDictionary 类的实例。第三个参数为 category,它不在 URL 模式中。由于它不在 URL 模式中,category 参数及其值将呈现为查询字符串参数。

  5. 在上一步中添加的代码后面,添加以下代码:
    VirtualPathData vpd =
    RouteTable.Routes.GetVirtualPath(null, “ExpensesRoute”, parameters);

    此代码通过调用RouteCollection类的GetVirtualPath方法,实例化VirtualPathData对象。由于 SalesRoute URL 模式和 ExpensesRoute URL 模式具有相似的占位符,因此它调用接受路由名称并指定 ExpensesRoute 值的重载。

  6. 在上一步中添加的代码后面,添加以下代码以设置超链接的 NavigateUrl 属性:
    HyperLink6.NavigateUrl = vpd.VirtualPath;

在 ASP.NET 页中访问 URL 参数值


在 ASP.NET 路由已调用的 ASP.NET 页中,可以在标记或代码中检索 URL 参数的值。例如,SalesReport 路由包括名为 locale 和 year 的参数,当收到匹配此模式的 URL 请求时,Sales.aspx 页中的代码可能需要将这些参数的值传递给 SQL 查询。

在下面的过程中,将使用标记访问 URL 参数值。此方法可用于在网页中显示参数值。

使用标记访问 URL 参数值
  1. 右击 Web 项目,然后单击“添加新项”。

    显示“添加新项”对话框。

  2. 选择 Web 窗体模板,然后将名称设置为“Expenses.aspx”。

    即会在“源”视图中打开 Expenses.aspx 页。

  3. 在开始和结束 <div> 标记之间添加以下标记:
    <h1>
    Expense Report for
    <asp:Literal ID=”Literal1″
    Text
    =”<%$RouteValue:locale%>”
    runat
    =”server”></asp:Literal>,
    <asp:Literal ID=”Literal2″
    Text
    =”<%$RouteValue:year%>”
    runat
    =”server”></asp:Literal>
    </h1>

    此标记使用 RouteValue 表达式提取并显示传递到页面的 URL 参数的值。

在下面的过程中,将使用代码访问参数值。此方法在您必须以某种方式(例如通过按此过程所示将 null 值转换为默认值,或通过将信息传递给 SQL 查询)处理数据时非常有用。

使用代码访问 URL 参数值
  1. 右击 Web 项目,然后单击“Add New Item”。

    显示“New Item”对话框。

  2. 选择“Web 窗体”模板,确保选中“将代码放在单独的文件中”,将名称设置为“Sales.aspx”,然后单击“添加”。

    即会在“源”视图中打开 Sales.aspx 页。

  3. 在开始和结束 <div> 标记之间添加以下标记:
    <h1>
    Sales Report for
    <asp:Literal ID=”LocaleLiteral” runat=”server”></asp:Literal>,
    <asp:Literal ID=”YearLiteral” runat=”server”></asp:Literal>
    </h1>

    此标记包括 Literal 控件,但不设置其 Text 属性,因为将在代码中设置这些属性。

  4. 在“Solution”中,展开 Sales.aspx,然后打开Sales.aspx.cs。
  5. 在 Page_Load 方法中,添加以下代码,将第一个 Literal 控件的 Text 属性设置为下列值之一:
    • 文本“所有区域设置”(如果 locale 参数为 null)。
    • locale 参数的值(如果 locale 参数不为 null)。
      LocaleLiteral.Text = Page.RouteData.Values["locale"] == null ?
          "All locales" : Page.RouteData.Values["locale"].ToString();
      
  6. 在 Page_Load 方法中,添加以下代码,以将第一个Literal控件的Text 属性设置为 year URL 参数的值:
    YearLiteral.Text = Page.RouteData.Values["year"].ToString();

测试路由


现在,可以测试路由。

测试路由
  1. 在“解决方案资源管理器”中右击 Links.aspx,并选择“在浏览器中查看”。

    该页将在浏览器中显示,如下图所示:

    Links.aspx 页面的屏幕快照

  2. 单击每个超链接。

    请注意,每个超链接转到一个其标题对应于该超链接的文本的页面。

  3. 回到 Links.aspx 页,选择浏览器的“查看源”命令,检查最后三个超链接的 URL。

    您将看到下面的自动生成的 URL:

    • http://[server]/[application]/SalesReportSummary/2011
    • http://[server]/[application]/SalesReport/CA/2009
    • http://[server]/[application]/ExpenseReport/CA/2008?category=recreation
  4. 将以 SalesReport/CA/2009 结束的 URL 复制到 Windows 剪贴板,然后关闭“查看源”窗口。
  5. 将该 URL 粘贴到浏览器的地址栏中,将 CA 更改为“invalidlocale”,将 2009 更改为“invalidyear”,然后按 Enter。

    将显示类似下图的页面:

    显示无效参数值的 SalesReport.aspx

    您可以看到显示 invalidlocale 和 invalidyear 值的销售报表页。由于没有为 SalesRoute 路由指定任何约束,因此接受无效数据。

  6. 再次将该 URL 粘贴到浏览器的地址栏中,将 CA 更改为“invalidlocale”,将 2009 更改为“invalidyear”,将 SalesReport 更改为“ExpenseReport”,然后按 Enter。

    将显示类似下图的页面:

    当费用报表 URL 违反约束时的错误

    由于 URL 未解析为路由,您会看到“未找到”错误。ExpenseReport 路由将仅接受具有两个字母字符的 locale 参数和具有四位数字的 year 参数。

原文链接

赞(0) 打赏
分享到: 更多 (0)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏