定位点标记帮助程序属性

当前位置：网站建设 > 技术支持

定位点标记帮助程序属性

资料来源：网络整理时间：2023/2/14 1:00:23 共计：3622 浏览

定位点标记帮助程序可通过添加新属性来增强标准的 HTML 定位点 (<a ... ></a>) 标记。按照约定，属性名称将使用前缀 asp-。 asp- 属性的值决定呈现的定位点元素的 href 属性值。

有关标记帮助程序的概述，请参阅 ASP.NET Core 中的标记帮助程序。

查看或下载示例代码（如何下载）

本文档中的示例均使用 SpeakerController：

using Microsoft.AspNetCore.Mvc;

using System.Collections.Generic;

using System.Linq;

public class SpeakerController : Controller

{

private List<Speaker> Speakers =

new List<Speaker>

{

new Speaker {SpeakerId = 10},

new Speaker {SpeakerId = 11},

new Speaker {SpeakerId = 12}

};

[Route("Speaker/{id:int}")]

public IActionResult Detail(int id) =>

View(Speakers.FirstOrDefault(a => a.SpeakerId == id));

[Route("/Speaker/Evaluations",

Name = "speakerevals")]

public IActionResult Evaluations() => View();

[Route("/Speaker/EvaluationsCurrent",

Name = "speakerevalscurrent")]

public IActionResult Evaluations(

int speakerId,

bool currentYear) => View();

public IActionResult Index() => View(Speakers);

}

public class Speaker

{

public int SpeakerId { get; set; }

}

定位点标记帮助程序属性

asp-controller

asp-controller 属性可分配用于生成 URL 的控制器。下面的标记列出了所有发言人：

CSHTML

<a asp-controller="Speaker"

asp-action="Index">All Speakers</a>

生成的 HTML：

HTML

<a href="/Speaker">All Speakers</a>

如果指定了 asp-controller 属性，而未指定 asp-action 属性，则默认的 asp-action 值为与当前正在执行的视图关联的控制器操作。如果前面标记中省略了，并且定位点标记帮助程序在控制器的索引视图中使用 asp-action () ，则生成的 HTML Home /Home 为：

HTML

<a href="/Home">All Speakers</a>

asp-action

asp-action 属性值表示生成的 href 属性中包含的控制器操作名称。下面的标记可将生成的 href 属性值设置为发言人评估页：

CSHTML

<a asp-controller="Speaker"

asp-action="Evaluations">Speaker Evaluations</a>

生成的 HTML：

HTML

<a href="/Speaker/Evaluations">Speaker Evaluations</a>

如果未指定 asp-controller 属性，则使用默认控制器，该控制器调用执行当前视图的视图。

如果 asp-action 属性值为 Index，则不向 URL 追加任何操作，从而导致调用默认的 Index 操作。 asp-controller 引用的控制器中必须存在指定的（或默认的）操作。

asp-route-{value}

asp-route-{value} 属性可实现通配符路由前缀。占用 {value} 占位符的所有值都解释为潜在的路由参数。如果找不到默认路由，则将此路由前缀作为请求参数和值追加到生成的 href 属性。否则，将在路由模板中替换它。

考虑以下控制器操作：

private List<Speaker> Speakers =

new List<Speaker>

{

new Speaker {SpeakerId = 10},

new Speaker {SpeakerId = 11},

new Speaker {SpeakerId = 12}

};

[Route("Speaker/{id:int}")]

public IActionResult Detail(int id) =>

View(Speakers.FirstOrDefault(a => a.SpeakerId == id));

在 Startup.Configure 中定义默认路由模板：

app.UseMvc(routes =>

{

// need route and attribute on controller: [Area("Blogs")]

routes.MapRoute(name: "mvcAreaRoute",

// default route for non-areas

routes.MapRoute(

});

MVC 视图使用操作提供的模型，如下所示：

CSHTML

@model Speaker

<!DOCTYPE html>

<html>

<body>

<a asp-controller="Speaker"

asp-action="Detail"

asp-route-id="@Model.SpeakerId">SpeakerId: @Model.SpeakerId</a>

</body>

</html>

默认路由的 {id?} 占位符得以匹配。生成的 HTML：

HTML

<a href="/Speaker/Detail/12">SpeakerId: 12</a>

假设路由前缀不属于匹配路由模板的一部分，如下面的 MVC 视图所示：

CSHTML

@model Speaker

<!DOCTYPE html>

<html>

<body>

<a asp-controller="Speaker"

asp-action="Detail"

asp-route-speakerid="@Model.SpeakerId">SpeakerId: @Model.SpeakerId</a>

<body>

</html>

生成以下 HTML，因为匹配的路由中未找到 speakerid：

HTML

<a href="/Speaker/Detail?speakerid=12">SpeakerId: 12</a>

如果 asp-controller 或 asp-action 均未指定，则会执行与 asp-route 属性中相同的默认处理。

asp-route

asp-route 属性用于创建直接链接到命名路由的 URL。使用路由属性，路由可以按 SpeakerController 中所示进行命名并用于其 Evaluations 操作：

#endregion

[Route("/Speaker/Evaluations",

在下列标记中，asp-route 属性引用命名路由：

CSHTML

<a asp-route="speakerevals">Speaker Evaluations</a>

定位点标记帮助程序使用 URL /Speaker/Evaluations 生成直接指向该控制器操作的路由。生成的 HTML：

HTML

<a href="/Speaker/Evaluations">Speaker Evaluations</a>

如果除了 asp-route，还指定了 asp-controller 或 asp-action，则可能不会生成预期的路由。为了避免发生路由冲突，不应将 asp-route 与 asp-controller 和 asp-action 属性结合使用。

asp-all-route-data

asp-all-route-data 属性支持创建键值对字典。键是参数名称，值是参数值。

在下面的示例中，将初始化字典并传递给 Razor 视图。或者，也可以使用模型传入数据。

CSHTML

var parms = new Dictionary<string, string>

{

{ "speakerId", "11" },

{ "currentYear", "true" }

};

}

<a asp-route="speakerevalscurrent"

asp-all-route-data="parms">Speaker Evaluations</a>

前面的代码生成以下 HTML：

HTML

<a href="/Speaker/EvaluationsCurrent?speakerId=11&currentYear=true">Speaker Evaluations</a>

平展 asp-all-route-data 字典，以生成满足重载 Evaluations 操作要求的查询字符串：

public IActionResult Evaluations() => View();

[Route("/Speaker/EvaluationsCurrent",

Name = "speakerevalscurrent")]

public IActionResult Evaluations(

如果字典中的任何键匹配路由参数，则将根据需要在路由中替换这些值。其他不匹配的值作为请求参数生成。

asp-fragment

asp-fragment 属性可定义要追加到 URL 的 URL 片段。定位点标记帮助程序添加哈希字符 (#)。请考虑以下标记：

CSHTML

<a asp-controller="Speaker"

asp-action="Evaluations"

asp-fragment="SpeakerEvaluations">Speaker Evaluations</a>

生成的 HTML：

HTML

<a href="/Speaker/Evaluations#SpeakerEvaluations">Speaker Evaluations</a>

生成客户端应用时，哈希标记很有用。它们可用于在 JavaScript 中轻松地执行标记和搜索等操作。

asp-area

asp-area 属性可设置用来设置相应路由的区域名称。以下示例展示了 asp-area 属性如何导致重新映射路由。

Pages 中的 Razor 使用情况

Razor2.1 ASP.NET Core支持页面区域。

考虑以下目录层次结构：

{Project name}

wwwroot

Areas

会话

页

_ViewStart.cshtml

Index.cshtml

Index.cshtml.cs

页

引用"会话"区域索引页**的标记 Razor 为：

CSHTML

<a asp-area="Sessions"

asp-page="/Index">View Sessions</a>

生成的 HTML：

HTML

<a href="/Sessions">View Sessions</a>

提示

若要支持 Pages 应用中 Razor 的区域，请执行中的下列操作之一 Startup.ConfigureServices ：

将兼容性版本设置为 2.1 或更高版本。

将 Razor PagesOptions.AllowAreas 属性设置为 true ：

services.AddMvc()

.AddRazorPagesOptions(options => options.AllowAreas = true);

MVC 中的使用情况

考虑以下目录层次结构：

{Project name}

wwwroot

Areas

Blogs

Controllers

HomeController.cs

Views

Home

AboutBlog.cshtml

Index.cshtml

_ViewStart.cshtml

Controllers

如果将 asp-area 设置为 “Blogs”，则会为此定位点标记的关联控制器和视图的路由添加目录 Areas/Blogs 作为前缀。用于引用 AboutBlog 视图的标记是：

CSHTML

<a asp-area="Blogs"

asp-controller="Home"

asp-action="AboutBlog">About Blog</a>

生成的 HTML：

HTML

<a href="/Blogs/Home/AboutBlog">About Blog</a>

提示

若要在 MVC 应用中支持区域，路由模板必须包含对该区域（如果存在）的引用。该模板由 Startup.Configure 中方法调用的第二 routes.MapRoute 个参数表示：

app.UseMvc(routes =>

{

// need route and attribute on controller: [Area("Blogs")]

routes.MapRoute(name: "mvcAreaRoute",

// default route for non-areas

routes.MapRoute(

});

asp-protocol

asp-protocol 属性用于在 URL 中指定协议（比如 https）。例如：

CSHTML

<a asp-protocol="https"

asp-controller="Home"

asp-action="About">About</a>

生成的 HTML：

HTML

<a href="https://localhost/Home/About">About</a>

示例中的主机名为 localhost。生成 URL 时，定位点标记帮助程序会使用网站的公共域。

asp-host

asp-host 属性用于在 URL 中指定主机名。例如：

CSHTML

<a asp-protocol="https"

asp-host="microsoft.com"

asp-controller="Home"

asp-action="About">About</a>

生成的 HTML：

HTML

<a href="https://microsoft.com/Home/About">About</a>

asp-page

Asp 页属性用于 Razor 页面。使用它向特定页设置定位点标记的 href 属性值。通过在页面名称前面使用正斜杠 (“/”) 作为前缀，可创建 URL。

以下示例指向 "与会者" Razor 页：

CSHTML

<a asp-page="/Attendee">All Attendees</a>

生成的 HTML：

HTML

<a href="/Attendee">All Attendees</a>

asp-page 属性与 asp-route、asp-controller 和 asp-action 属性互斥。但是，asp-page 可与 asp-route-{value} 结合使用以控制路由，如以下标记所示：

CSHTML

<a asp-page="/Attendee"

asp-route-attendeeid="10">View Attendee</a>

生成的 HTML：

HTML

<a href="/Attendee?attendeeid=10">View Attendee</a>

asp-page-handler

Asp 页处理程序属性与页一起使用 Razor 。它用于链接到特定的页处理程序。

请考虑以下页处理程序：

public void OnGetProfile(int attendeeId)

{

ViewData["AttendeeId"] = attendeeId;

// code omitted for brevity

}

页模型的关联标记链接到 OnGetProfile 页处理程序。注意，asp-page-handler 属性值中省略了页处理程序方法名称的 On<Verb> 前缀。如果方法是异步的，也省略 Async 后缀。

CSHTML

<a asp-page="/Attendee"

asp-page-handler="Profile"

asp-route-attendeeid="12">Attendee Profile</a>

生成的 HTML：

HTML

<a href="/Attendee?attendeeid=12&handler=Profile">Attendee Profile</a>

版权说明：
本网站凡注明“广州京杭原创”的皆为本站原创文章，如需转载请注明出处！
本网转载皆注明出处，遵循行业规范，如发现作品内容版权或其它问题的，请与我们联系处理！
欢迎扫描右侧微信二维码与我们联系。

·上一条：.NET 通过 Autofac 和 DynamicProxy 实现AOP | ·下一条：ASP.NET Core 中的环境标记帮助程序