ASP NET MVC系列 补充

mvc5项目的IIS部署

发布项目

右击项目 - 发布

img

选择IIS - 点击发布

img

发布方法 - 文件系统,目标位置 - 选择与项目所在目录不同的目录(也即,指定一个发布生成文件的目录),文件发布选项 - 不选 - 点击发布

 

安装IIS

点击windows徽标 - 设置 - 应用和功能 - 右侧程序和功能

img

左侧 - 启用或关闭windows功能

img

把"Web 管理工具" 和 "万维网服务" 全部选择吧, 不然你会发现你的IIS 比别人少了很多东西, 并且MVC 的404 无法解决

img

在程序列表中找到IIS管理器图标并打开它。

img

 

 

部署web项目到IIS

右击网站 - 添加网站

img

只需要指定:网站名、刚才发布的项目所在根目录、端口即可

img

双击应用程序池,在中间面板中的列表如果不像下面的图那样,则说明IIS没安装完全。

img

至此网站已经部署到了IIS,可以单击IIS管理器左侧的网站图标,再单击右侧的浏览网站即可测试

img

 

附加正在开发的项目到IIS

不需要发布项目,直接在IIS中添加网站,路径选择项目所在目录即可。如果在vs中修改了源代码,通过浏览器访问网站前一定要先编译项目,否则网站不会执行已经修改过的程序。当需要调试项目时,可以使用附加到进程,前提是IIS中的web程序已经在运行在w3wp.exe中。在以管理员身份登录的vs中创建断点 - 编译项目 - 点击菜单栏的调试菜单 - 附加到进程 - 勾选显示所有进程 - 双击w3wp.exe。如果w3wp.exe不在进程列表,可以先向IIS发起一个请求,打开网页,此时w3wp.exe会出现在vs附加到进程的进程列表中。

 

常见错误:

用户 'IIS APPPOOL\XXX' 登录失败。

解决方法:双击应用程序池 - 在面板中间右键选择你的web程序所在应用程序池 - 高级设置 - 进程模型 - 选择合适的登录数据库的模式

如果列表中的选项都无效,则选择ApplicationPoolIdentity,然后在web.config中将数据库连接字符串改为用户密码登录,比如sa

 

如果双击"处理程序映射"时报下面的错误:是因为IIS7采用了集成管道模式,锁定了module和handler

处理程序映射 --------------------------- 执行此操作时出错。

解决方法:

管理员身份运行命令行解锁: C:\windows\system32\inetsrv\appcmd unlock config -section:system.webServer/handlers C:\windows\system32\inetsrv\appcmd unlock config -section:system.webServer/modules

img

 

无法识别的属性“targetFramework”。请注意属性名称区分大小写。

 

Razor 语法参考

作者: Rick AndersonTaylor MullenDan Vicarel

Razor 是一种标记语法,用于将基于服务器的代码嵌入网页中。 Razor 语法由 Razor 标记、C# 和 HTML 组成。 包含 Razor 的文件通常具有 .cshtml 文件扩展名。 在 Razor 组件文件 (.razor) 中也可以找到 Razor。

呈现 HTML

默认 Razor 语言为 HTML。 从 Razor 标记呈现 HTML 与从 HTML 文件呈现 HTML 并没有什么不同。 服务器会按原样呈现 .cshtml Razor 文件中的 HTML 标记。

Razor 语法

Razor 支持 C#,并使用 @ 符号从 HTML 转换为 C#。 Razor 计算 C# 表达式,并将它们呈现在 HTML 输出中。

@ 符号后跟 Razor 保留关键字时,它会转换为 Razor 特定标记。 否则会转换为纯 C#

若要对 Razor 标记中的 @ 符号进行转义,请使用另一个 @ 符号

CSHTML

<p>@@Username</p>

该代码在 HTML 中使用单个 @ 符号呈现:

HTML

<p>@Username</p>

包含电子邮件地址的 HTML 属性和内容不将 @ 符号视为转换字符。 Razor 分析不会处理以下示例中的电子邮件地址:

CSHTML

<a href="mailto:Support@contoso.com">Support@contoso.com</a>

隐式 Razor 表达式

隐式 Razor 表达式以 @ 开头,后跟 C# 代码:

CSHTML

<p>@DateTime.Now</p>
<p>@DateTime.IsLeapYear(2016)</p>

隐式表达式不能包含空格,但 C# await 关键字除外。 如果该 C# 语句具有明确的结束标记,则可以混用空格:

CSHTML

<p>@await DoSomething("hello", "world")</p>

隐式表达式不能包含 C# 泛型,因为括号 (<>) 内的字符会被解释为 HTML 标记。 以下代码效:

CSHTML

<p>@GenericMethod<int>()</p>

上述代码生成与以下错误之一类似的编译器错误:

  • "int" 元素未结束。 所有元素都必须自结束或具有匹配的结束标记。

  • 无法将方法组 "GenericMethod" 转换为非委托类型 "object"。 是否希望调用此方法?`

泛型方法调用必须包装在显式 Razor 表达式或 Razor 代码块中。

显式 Razor 表达式

显式 Razor 表达式由 @ 符号和平衡圆括号组成。 若要呈现上一周的时间,可使用以下 Razor 标记:

CSHTML

<p>Last week this time: @(DateTime.Now - TimeSpan.FromDays(7))</p>

将计算 @() 括号中的所有内容,并将其呈现到输出中。

前面部分中所述的隐式表达式通常不能包含空格。 在下面的代码中,不会从当前时间减去一周:

CSHTML

<p>Last week: @DateTime.Now - TimeSpan.FromDays(7)</p>

该代码呈现以下 HTML:

HTML

<p>Last week: 7/7/2016 4:39:52 PM - TimeSpan.FromDays(7)</p>

可以使用显式表达式将文本与表达式结果串联起来:

CSHTML

@{
  var joe = new Person("Joe", 33);
}

<p>Age@(joe.Age)</p>

上面代码中如果不使用显式表达式,Age@joe.Age 会被视为电子邮件地址,因此会呈现 Age@joe.Age。 如果编写为显式表达式,则呈现 Age33

显式表达式可用于从 .cshtml 文件中的泛型方法呈现输出。 以下标记显示了如何更正之前出现的由 C# 泛型的括号引起的错误。 此代码以显式表达式的形式编写:

CSHTML

<p>@(GenericMethod<int>())</p>

表达式编码

计算结果为字符串的 C# 表达式采用 HTML 编码。 计算结果为 IHtmlContent 的 C# 表达式直接通过 IHtmlContent.WriteTo 呈现。 计算结果不为 IHtmlContent 的 C# 表达式通过 ToString 转换为字符串,并在呈现前进行编码。

CSHTML

@("<span>Hello World</span>")

该代码呈现以下 HTML:

HTML

&lt;span&gt;Hello World&lt;/span&gt;

该 HTML 在浏览器中显示为:

HTML

<span>Hello World</span>

HtmlHelper.Raw 输出不进行编码,但呈现为 HTML 标记。

警告

对未经审查的用户输入使用 HtmlHelper.Raw 会带来安全风险。 用户输入可能包含恶意的 JavaScript 或其他攻击。 审查用户输入比较困难。 应避免对用户输入使用 HtmlHelper.Raw

CSHTML

@Html.Raw("<span>Hello World</span>")

该代码呈现以下 HTML:

HTML

<span>Hello World</span>

Razor 代码块

Razor 代码块以 @ 开头,并括在 {} 中。 代码块内的 C# 代码不会呈现,这点与表达式不同。 一个视图中的代码块和表达式共享相同的作用域并按顺序进行定义:

CSHTML

@{
  var quote = "The future depends on what you do today. - Mahatma Gandhi";
}

<p>@quote</p>

@{
  quote = "Hate cannot drive out hate, only love can do that. - Martin Luther King, Jr.";
}

<p>@quote</p>

该代码呈现以下 HTML:

HTML

<p>The future depends on what you do today. - Mahatma Gandhi</p>
<p>Hate cannot drive out hate, only love can do that. - Martin Luther King, Jr.</p>

在代码块中,使用标记将本地函数声明为用作模板化方法:

CSHTML

@{
    void RenderName(string name)
    {
        <p>Name: <strong>@name</strong></p>
    }

    RenderName("Mahatma Gandhi");
    RenderName("Martin Luther King, Jr.");
}

该代码呈现以下 HTML:

HTML

<p>Name: <strong>Mahatma Gandhi</strong></p>
<p>Name: <strong>Martin Luther King, Jr.</strong></p>
隐式转换

代码块中的默认语言为 C#,不过,Razor 页面可以转换回 HTML:

CSHTML

@{
  var inCSharp = true;
  <p>Now in HTML, was in C# @inCSharp</p>
}
带分隔符的显式转换

若要定义应呈现 HTML 的代码块子节,请使用 Razor `` 标记将要呈现的字符括起来:

CSHTML

@for (var i = 0; i < people.Length; i++)
{
  var person = people[i];
  <text>Name: @person.Name</text>
}

使用此方法可呈现未被 HTML 标记括起来的 HTML。 如果没有 HTML 或 Razor 标记,会发生 Razor 运行时错误。

`` 标记可用于在呈现内容时控制空格:

  • 仅呈现 `` 标记之间的内容。

  • `` 标记之前或之后的空格不会显示在 HTML 输出中。

显式行转换

要在代码块内以 HTML 形式呈现整个行的其余内容,请使用 @: 语法:

CSHTML

@for (var i = 0; i < people.Length; i++)
{
  var person = people[i];
  @:Name: @person.Name
}

如果代码中没有 @:,会生成 Razor 运行时错误。

Razor 文件中多余的 @ 字符可能会导致代码块中后面的语句发生编译器错误。 这些编译器错误可能难以理解,因为实际错误发生在报告的错误之前。 将多个隐式/显式表达式合并到单个代码块以后,经常会发生此错误。

控制结构

控制结构是对代码块的扩展。 代码块的各个方面(转换为标记、内联 C#)同样适用于以下结构:

条件语句 @、else if、else 和 @switch

@if 控制何时运行代码:

CSHTML

@if (value % 2 == 0)
{
    <p>The value was even.</p>
}

elseelse if 不需要 @ 符号:

CSHTML

@if (value % 2 == 0)
{
    <p>The value was even.</p>
}
else if (value >= 1337)
{
    <p>The value is large.</p>
}
else
{
    <p>The value is odd and small.</p>
}

以下标记展示如何使用 switch 语句:

CSHTML

@switch (value)
{
  case 1:
      <p>The value is 1!</p>
      break;
  case 1337:
      <p>Your number is 1337!</p>
      break;
  default:
      <p>Your number wasn't 1 or 1337.</p>
      break;
}

循环语句 @for、@foreach、@while 和 @dowhile

可以使用循环控制语句呈现模板化 HTML。 若要呈现一组人员:

CSHTML

@{
  var people = new Person[]
  {
        new Person("Weston", 33),
        new Person("Johnathon", 41),
        ...
  };
}

支持以下循环语句:

@for

CSHTML

@for (var i = 0; i < people.Length; i++)
{
    var person = people[i];
    <p>Name: @person.Name</p>
    <p>Age: @person.Age</p>
}

@foreach

CSHTML

@foreach (var person in people)
{
  <p>Name: @person.Name</p>
  <p>Age: @person.Age</p>
}

@while

CSHTML

@{ var i = 0; }
@while (i < people.Length)
{
  var person = people[i];
  <p>Name: @person.Name</p>
  <p>Age: @person.Age</p>

  i++;
}

@do while

CSHTML

@{ var i = 0; }
@do
{
  var person = people[i];
  <p>Name: @person.Name</p>
  <p>Age: @person.Age</p>

  i++;
} while (i < people.Length);

复合语句

@using

在 C# 中,using 语句用于确保释放对象。 在 Razor 中,可使用相同的机制来创建包含附加内容的 HTML 帮助程序。 在下面的代码中,HTML 帮助程序使用 ` 语句呈现@using` 标记:

CSHTML

@using (Html.BeginForm())
{
  <div>
      Email: <input type="email" id="Email" value="">
      <button>Register</button>
  </div>
}

@try、catch、finally

异常处理与 C# 类似:

CSHTML

@try
{
  throw new InvalidOperationException("You did something invalid.");
}
catch (Exception ex)
{
  <p>The exception message: @ex.Message</p>
}
finally
{
  <p>The finally statement.</p>
}

@lock

Razor 可以使用 lock 语句来保护关键节:

CSHTML

@lock (SomeLock)
{
  // Do critical section work
}

注释

Razor 支持 C# 和 HTML 注释:

CSHTML

@{
  /* C# comment */
  // Another C# comment
}
<!-- HTML comment -->

该代码呈现以下 HTML:

HTML

<!-- HTML comment -->

在呈现网页之前,服务器会删除 Razor 注释。 Razor 使用 @* *@ 来分隔注释。 以下代码已被注释禁止,因此服务器不呈现任何标记:

CSHTML

@*
  @{
      /* C# comment */
      // Another C# comment
  }
  <!-- HTML comment -->
*@

指令

Razor 指令由隐式表达式表示:@ 符号后跟保留关键字。 指令通常用于更改视图分析方式或启用不同的功能。

通过了解 Razor 如何为视图生成代码,更易理解指令的工作原理。

CSHTML

@{
  var quote = "Getting old ain't for wimps! - Anonymous";
}

<div>Quote of the Day: @quote</div>

该代码生成与下面类似的类:

C#

public class _Views_Something_cshtml : RazorPage<dynamic>
{
  public override async Task ExecuteAsync()
  {
      var output = "Getting old ain't for wimps! - Anonymous";

      WriteLiteral("/r/n<div>Quote of the Day: ");
      Write(output);
      WriteLiteral("</div>");
  }
}

本文后面的检查为视图生成的 Razor C# 类部分说明了如何查看此生成的类。

@attribute

@attribute 指令将给定的属性添加到生成的页或视图的类中。 以下示例添加 [Authorize] 属性:

CSHTML

@attribute [Authorize]

@code

此方案仅适用于 Razor 组件 (.razor)。

@code 块允许 Razor 组件将 C# 成员(字段、属性和方法)添加到组件:

razor

@code {
  // C# members (fields, properties, and methods)
}

对于 Razor 组件,@code@functions 的别名,并且优先于 @functions 使用。 允许多个 @code 块。

@functions

@functions 指令允许将 C# 成员(字段、属性和方法)添加到生成的类中:

CSHTML

@functions {
  // C# members (fields, properties, and methods)
}

Razor 组件中,请使用 @code 而不是 @functions 来添加 C# 成员。

例如:

CSHTML

@functions {
  public string GetHello()
  {
      return "Hello";
  }
}

<div>From method: @GetHello()</div>

该代码生成以下 HTML 标记:

HTML

<div>From method: Hello</div>

以下代码是生成的 Razor C# 类:

C#

using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc.Razor;

public class _Views_Home_Test_cshtml : RazorPage<dynamic>
{
  // Functions placed between here
  public string GetHello()
  {
      return "Hello";
  }
  // And here.
#pragma warning disable 1998
  public override async Task ExecuteAsync()
  {
      WriteLiteral("\r\n<div>From method: ");
      Write(GetHello());
      WriteLiteral("</div>\r\n");
  }
#pragma warning restore 1998

@functions 方法有标记时,会用作模板化方法:

CSHTML

@{
  RenderName("Mahatma Gandhi");
  RenderName("Martin Luther King, Jr.");
}

@functions {
  private void RenderName(string name)
  {
      <p>Name: <strong>@name</strong></p>
  }
}

该代码呈现以下 HTML:

HTML

<p>Name: <strong>Mahatma Gandhi</strong></p>
<p>Name: <strong>Martin Luther King, Jr.</strong></p>

@implements

@implements 指令为生成的类实现接口。

以下示例实现 System.IDisposable,以便可以调用 Dispose 方法:

CSHTML

@implements IDisposable

<h1>Example</h1>

@functions {
  private bool _isDisposed;

  ...

  public void Dispose() => _isDisposed = true;
}

@inherits

@inherits 指令对视图继承的类提供完全控制:

CSHTML

@inherits TypeNameOfClassToInheritFrom

下面的代码是一种自定义 Razor 页面类型:

C#

using Microsoft.AspNetCore.Mvc.Razor;

public abstract class CustomRazorPage<TModel> : RazorPage<TModel>
{
  public string CustomText { get; } =
      "Gardyloo! - A Scottish warning yelled from a window before dumping" +
      "a slop bucket on the street below.";
}

CustomText 显示在视图中:

CSHTML

@inherits CustomRazorPage<TModel>

<div>Custom text: @CustomText</div>

该代码呈现以下 HTML:

HTML

<div>
  Custom text: Gardyloo! - A Scottish warning yelled from a window before dumping
  a slop bucket on the street below.
</div>

@model@inherits 可在同一视图中使用。 @inherits 可位于视图导入的 _ViewImports.cshtml 文件中:

CSHTML

@inherits CustomRazorPage<TModel>

下面的代码是一种强类型视图:

CSHTML

@inherits CustomRazorPage<TModel>

<div>The Login Email: @Model.Email</div>
<div>Custom text: @CustomText</div>

如果在模型中传递“rick@contoso.com”,视图将生成以下 HTML 标记:

HTML

<div>The Login Email: rick@contoso.com</div>
<div>
  Custom text: Gardyloo! - A Scottish warning yelled from a window before dumping
  a slop bucket on the street below.
</div>

@inject

@inject 指令允许 Razor 页面将服务从服务容器注入到视图。 有关详细信息,请参阅视图中的依赖关系注入

@layout

此方案仅适用于 Razor 组件 (.razor)。

@layout 指令指定 Razor 组件的布局。 布局组件用于避免代码重复和不一致。 有关详细信息,请参阅 ASP.NET Core Blazor 布局

@model

此方案仅适用于 MVC 视图和 Razor Pages (.cshtml)。

@model 指令指定传递到视图或页面的模型类型:

CSHTML

@model TypeNameOfModel

在使用个人用户帐户创建的 ASP.NET Core MVC 或 Razor Pages 应用中,Views/Account/Login.cshtml 包含以下模型声明:

CSHTML

@model LoginViewModel

生成的类继承自 RazorPage

C#

public class _Views_Account_Login_cshtml : RazorPage<LoginViewModel>

Razor 公开了 Model 属性,用于访问传递到视图的模型:

CSHTML

<div>The Login Email: @Model.Email</div>

@model 指令指定 Model 属性的类型。 该指令将 T 中的 RazorPage 指定为生成的类,视图便派生自该类。 如果未指定 @model 指令,则 Model 属性的类型为 dynamic。 有关详细信息,请参阅强类型模型和 @model 关键字

@namespace

@namespace 指令:

  • 设置生成的 Razor 页面、MVC 视图或 Razor 组件的类的命名空间。

  • 从目录树中最近的导入文件、_ViewImports.cshtml(视图或页面)或 _Imports.razor (Razor) 中设置页面、视图或组件类的根派生命名空间。

CSHTML

@namespace Your.Namespace.Here

对于下表中显示的 Razor Pages 示例:

  • 每个页面都导入 Pages/_ViewImports.cshtml。

  • Pages/_ViewImports.cshtml 包含@namespace Hello.World

  • 每个页面都有 Hello.World,作为其命名空间的根。

命名空间
Pages/Index.cshtml Hello.World
Pages/MorePages/Page.cshtml Hello.World.MorePages
Pages/MorePages/EvenMorePages/Page.cshtml Hello.World.MorePages.EvenMorePages

上述关系适用于与 MVC 视图和 Razor 组件一起使用的导入文件。

当多个导入文件具有 @namespace 指令时,最靠近目录树中的页面、视图或组件的文件将用于设置根命名空间。

如果前面示例中的 EvenMorePages 文件夹具有包含 的导入文件(或 Pages/MorePages/EvenMorePages/Page.cshtml 文件包含),则结果如下表所示@namespace Another.Planet``@namespace Another.Planet

命名空间
Pages/Index.cshtml Hello.World
Pages/MorePages/Page.cshtml Hello.World.MorePages
Pages/MorePages/EvenMorePages/Page.cshtml Another.Planet

@page

@page 指令具有不同的效果,具体取决于其所在文件的类型。 指令:

@section

此方案仅适用于 MVC 视图和 Razor Pages (.cshtml)。

@section 指令与 MVC 和 Razor Pages 布局结合使用,允许视图或页面将内容呈现在 HTML 页面的不同部分。 有关详细信息,请参阅 ASP.NET Core 中的布局

@using

@using 指令用于向生成的视图添加 C# using 指令:

CSHTML

@using System.IO
@{
  var dir = Directory.GetCurrentDirectory();
}
<p>@dir</p>

Razor 组件中,@using 还可控制哪些组件在范围内。

指令属性

@attributes

此方案仅适用于 Razor 组件 (.razor)。

@attributes 允许组件呈现未声明的属性。 有关详细信息,请参阅 创建和使用 ASP.NET Core Razor 组件

@bind

此方案仅适用于 Razor 组件 (.razor)。

组件中的数据绑定通过 @bind 属性实现。 有关详细信息,请参阅 ASP.NET Core Blazor 数据绑定

@on{EVENT}

此方案仅适用于 Razor 组件 (.razor)。

Razor 为组件提供事件处理功能。 有关详细信息,请参阅 ASP.NET Core Blazor 事件处理

@on{EVENT}:preventDefault

此方案仅适用于 Razor 组件 (.razor)。

禁止事件的默认操作。

@on{EVENT}:stopPropagation

此方案仅适用于 Razor 组件 (.razor)。

停止事件的事件传播。

@key

此方案仅适用于 Razor 组件 (.razor)。

@key 指令属性使组件比较算法保证基于键的值保留元素或组件。 有关详细信息,请参阅 创建和使用 ASP.NET Core Razor 组件

@ref

此方案仅适用于 Razor 组件 (.razor)。

组件引用 (@ref) 提供了一种引用组件实例的方法,以便可以向该实例发出命令。 有关详细信息,请参阅 创建和使用 ASP.NET Core Razor 组件

@typeparam

此方案仅适用于 Razor 组件 (.razor)。

@typeparam 指令声明生成的组件类的泛型类型参数。 有关详细信息,请参阅 ASP.NET Core Blazor 模板化组件

模板化 Razor 委托

通过 Razor 模板,可使用以下格式定义 UI 代码片段:

CSHTML

@<tag>...</tag>

下面的示例演示如何指定模板化 Razor 委托作为 Func。 为委托封装的方法的参数指定动态类型。 将对象类型指定为委托的返回值。 该模板与 List(具有 Pet 属性)的 Name 一起使用。

C#

public class Pet
{
  public string Name { get; set; }
}

CSHTML

@{
  Func<dynamic, object> petTemplate = @<p>You have a pet named <strong>@item.Name</strong>.</p>;

  var pets = new List<Pet>
  {
      new Pet { Name = "Rin Tin Tin" },
      new Pet { Name = "Mr. Bigglesworth" },
      new Pet { Name = "K-9" }
  };
}

使用 pets 语句提供的 foreach 呈现该模板:

CSHTML

@foreach (var pet in pets)
{
  @petTemplate(pet)
}

呈现的输出:

HTML

<p>You have a pet named <strong>Rin Tin Tin</strong>.</p>
<p>You have a pet named <strong>Mr. Bigglesworth</strong>.</p>
<p>You have a pet named <strong>K-9</strong>.</p>

还可以提供内联 Razor 模板作为方法的参数。 如下示例中,Repeat 方法收到一个 Razor 模板。 该方法使用模板生成 HTML 内容,其中包含列表中提供的重复项:

CSHTML

@using Microsoft.AspNetCore.Html

@functions {
  public static IHtmlContent Repeat(IEnumerable<dynamic> items, int times,
      Func<dynamic, IHtmlContent> template)
  {
      var html = new HtmlContentBuilder();

      foreach (var item in items)
      {
          for (var i = 0; i < times; i++)
          {
              html.AppendHtml(template(item));
          }
      }

      return html;
  }
}

使用前面示例中的 pets 列表,调用 Repeat 方法以及:

  • ListPet

  • 每只宠物的重复次数。

  • 用于无序列表的列表项的内联模板。

CSHTML

<ul>
  @Repeat(pets, 3, @<li>@item.Name</li>)
</ul>

呈现的输出:

HTML

<ul>
  <li>Rin Tin Tin</li>
  <li>Rin Tin Tin</li>
  <li>Rin Tin Tin</li>
  <li>Mr. Bigglesworth</li>
  <li>Mr. Bigglesworth</li>
  <li>Mr. Bigglesworth</li>
  <li>K-9</li>
  <li>K-9</li>
  <li>K-9</li>
</ul>

标记帮助程序

此方案仅适用于 MVC 视图和 Razor Pages (.cshtml)。

标记帮助程序有三个相关指令。

指令函数
@addTagHelper 向视图提供标记帮助程序。
@removeTagHelper 从视图中删除以前添加的标记帮助程序。
@tagHelperPrefix 指定标记前缀,以启用标记帮助程序支持并阐明标记帮助程序的用法。

Razor 保留关键字

Razor 关键字

  • page(需要 ASP.NET Core 2.1 或更高版本)

  • 命名空间

  • functions

  • 继承

  • model

  • section

  • helper(ASP.NET Core 当前不支持)

Razor 关键字使用 @(Razor Keyword) 进行转义(例如,@(functions))。

C# Razor 关键字

  • case

  • do

  • default

  • for

  • foreach

  • if

  • else

  • lock

  • 开关

  • 尝试

  • catch

  • finally

  • 借助

  • while

C# Razor 关键字必须使用 @(@C# Razor Keyword) 进行双转义(例如,@(@case))。 第一个 @ 对 Razor 分析器转义。 第二个 @ 对 C# 分析器转义。

Razor 不使用的保留关键字

  • class

检查为视图生成的 Razor C# 类

在 .NET Core SDK 2.1 或更高版本中,Razor SDK 负责编译 Razor 文件。 生成项目时,Razor SDK 在项目根目录中生成 obj/<build_configuration>/<target_framework_moniker>/Razor 目录。 Razor 目录中的目录结构反映项目的目录结构。

在面向 .NET Core 2.1 的 ASP.NET Core 2.1 Razor Pages 项目中,请考虑以下目录结构:

  • Areas/

    • Admin/

      • Pages/

        • Index.cshtml

        • Index.cshtml.cs

  • Pages/

    • Shared/

      • _Layout.cshtml

    • _ViewImports.cshtml

    • _ViewStart.cshtml

    • Index.cshtml

    • Index.cshtml.cs

在 Debug 配置下生成项目将生成以下 obj 目录:

  • obj/

    • Debug/

      • netcoreapp2.1/

        • Razor/

          • Areas/

            • Admin/

              • Pages/

                • Index.g.cshtml.cs

          • Pages/

            • Shared/

              • _Layout.g.cshtml.cs

            • _ViewImports.g.cshtml.cs

            • _ViewStart.g.cshtml.cs

            • Index.g.cshtml.cs

若要查看 Pages/Index.cshtml 的生成类,请打开 obj/Debug/netcoreapp2.1/Razor/Pages/Index.g.cshtml.cs。

视图查找和区分大小写

Razor 视图引擎为视图执行区分大小写的查找。 但是,实际查找取决于基础文件系统:

  • 基于文件的源:

    • 在使用不区分大小写的文件系统的操作系统(例如,Windows)上,物理文件提供程序查找不区分大小写。 例如,return View("Test") 可匹配 /Views/Home/Test.cshtml/Views/home/test.cshtml 以及任何其他大小写变体。

    • 在区分大小写的文件系统(例如,Linux、OSX 以及使用 EmbeddedFileProvider 构建的文件系统)上,查找区分大小写。 例如,return View("Test") 专门匹配 /Views/Home/Test.cshtml

  • 预编译视图:在 ASP.NET Core 2.0 及更高版本中,预编译视图查找在所有操作系统上均不区分大小写。 该行为与 Windows 上物理文件提供程序的行为相同。 如果两个预编译视图仅大小写不同,则查找的结果具有不确定性。

建议开发人员将文件和目录名称的大小写与以下项的大小写匹配:

  • 区域、控制器和操作名称。

  • Razor 页面。

匹配大小写可确保无论使用哪种基础文件系统,部署都能找到其视图。

 

Area区域的使用

在大型的ASP.NET mvc5项目中一般都有许多个功能模块,这些功能模块可以用Area(中文翻译为区域)把它们分离开来,比如:Admin,Customer,Bill。ASP.NET MVC项目中把各个功能分为不同Area的之后每一个Area都有独立的Controller,View文件结构。这样可以把这些功能分给不同的开发者同时开发而彼此之间不会冲突,这样的文件结构各司其职,直观明了,易于维护和管理。下面我们看看怎么在ASP.NET MVC5中创建一个Area和Area直接之间链接的处理。

ASP.NET MVC5中创建Area区域

选中我们的ASP.NET MVC项目,右键菜单,添加=》区域,这里我们取名为Admin,在项目根目录将会生成一个Admin文件夹,如下图:

img

我们来看这个Area是怎么在项目的起作用的。

我们来看Global.asax.cs的代码:

复制代码
public class MvcApplication : System.Web.HttpApplication
{
protected void Application_Start()
{
  AreaRegistration.RegisterAllAreas();
  FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
  RouteConfig.RegisterRoutes(RouteTable.Routes);
  BundleConfig.RegisterBundles(BundleTable.Bundles);
}
}
复制代码

第一行的代码:AreaRegistration.RegisterAllAreas();就是注册 ASP.NET MVC 应用程序中的所有区域。每一个区域它有自己的都有独立的Controller,View文件结构和路由配置,我们完全可以把ASP.NET MVC的区域看成一个ASP.NET MVC项目。

注意: RouteConfig.RegisterRoutes(RouteTable.Routes)在AreaRegistration.RegisterAllAreas();的后面。这一点很关键,你最好是不要改变这个顺序。之前我们谈到过ASP.NET MVC路由系统是按注册路由的先后顺序来匹配的,这里RegisterAllAreas在前面表示MVC路由系统会先去匹配Area中的路由配置规则,如果你改变了顺序可能会找到错误的Controller,发生意外的错误。

在ASP.NET MVC5的每个区域都有一个类:区域名+AreaRegistration,比如我们刚才建的一个Admin区域AdminAreaRegistration类:

复制代码
public class AdminAreaRegistration : AreaRegistration 
    {
        public override string AreaName 
        {
            get 
            {
                return "Admin";
            }
        }
 
        public override void RegisterArea(AreaRegistrationContext context) 
        {
            context.MapRoute(
                "Admin_default",
                "Admin/{controller}/{action}/{id}",
                new { action = "Index", id = UrlParameter.Optional }
            );
        }
    }
复制代码

这个类的作用主要是用于标示区域名称和区域Controller的路由,可以看到路由规则为"Admin/{controller}/{action}/{id}",前面统一跟了一个Admin。

在Area区域的视图之间Action的链接跳转的处理

当在ASP.NET MVC项目中使用了AreaArea区域后,会涉及到不同Area的Action链接之间相互跳转,我使用Html.ActionLink有些地方需要注意。

同一个Area之间跳转

在Area区域的视图中生成指向同一个Area的Action链接时,你不需要做任何处理,当你调用Html.ActionLink时MVC框架自动去找当前Area的相应路由来生成Action的链接。如下:

  1. @Html.ActionLink("Click me", "About")

生成下面的html:

  1. <a href="/Admin/Home/About">Click me</a>

不同Area之间跳转

  1. @Html.ActionLink("Click me to go to another area", "Index", new { area = "Support" })

把Route中的area指定就可以了。

跳转到不带Area的Action

我们知道使用Html.ActionLink没有指定area,默认就是当前的area。有时我们需要链接到顶层的Controller的Action,就是不要带area,也很简单,只需要把area传空字符串就可以了。如下:

@Html.ActionLink("Click me to go to another area", "Index", new { area = "" })

posted @   明志德道  阅读(198)  评论(0编辑  收藏  举报
编辑推荐:
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
阅读排行:
· 在鹅厂做java开发是什么体验
· 百万级群聊的设计实践
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战
· 永远不要相信用户的输入:从 SQL 注入攻防看输入验证的重要性
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
点击右上角即可分享
微信分享提示