razor html帮助器,在 ASP.NET 网页（Razor）网站中创建和使用帮助器 | Microsoft Docs

在 ASP.NET 网页(Razor)网站中创建和使用 Helper

02/17/2014

本文内容

本文介绍如何在 ASP.NET 网页(Razor)网站中创建帮助程序。 帮助器是一种可重用的组件，其中包括用于执行可能比较繁琐或复杂的任务的代码和标记。

你将学习的内容：

如何创建和使用简单的帮助器。

下面是本文中介绍的 ASP.NET 功能：

@helper 语法。

本教程中使用的软件版本

ASP.NET 网页(Razor)3

本教程还适用于 ASP.NET 网页2。

帮助器概述

如果需要在站点中的不同页面上执行相同的任务，则可以使用帮助程序。 ASP.NET 网页包括多个帮助程序，你可以下载和安装更多的帮助程序。 ( ASP.NET API 快速参考中列出了 ASP.NET 网页中的内置帮助程序列表。)如果现有的帮助程序都不能满足您的需要，您可以创建自己的帮助程序。

利用帮助程序，可以在多个页中使用通用代码块。 假设你经常需要在页面中创建与普通段落分开设置的注释项。 也许会将便笺创建为样式为带有边框的框的

元素。 您不必在每次要显示便笺时将此同一标记添加到页面，而是可以将标记打包为帮助程序。 然后，你可以在所需的任何位置使用一行代码插入注释。

使用与此类似的帮助程序使每个页面中的代码更简单且更易于阅读。 它还使您可以更轻松地维护站点，因为如果您需要更改便笺的外观，则可以在一个位置更改标记。

创建帮助程序

此过程说明如何创建创建注释的帮助器，如刚才所述。 这是一个简单的示例，但自定义帮助器可以包含所需的任何标记和 ASP.NET 代码。

在网站的根文件夹中，创建名为 "应用_ 的文件夹"。 这是 ASP.NET 中的保留文件夹名称，你可以在其中将代码用于组件(如帮助程序)。

在应用_代码文件夹中，创建一个新的cshtml文件并将其命名为MyHelpers。

将现有内容替换为以下内容：

@helper MakeNote(string content) {

style="border: 1px solid black; width: 90%; padding: 5px; margin-left: 15px;">

Note   @content

}

代码使用 @helper 语法来声明名为 MakeNote的新帮助器。 此特定帮助器使你可以传递一个名为 content 的参数，该参数可以包含文本和标记的组合。 帮助器使用 @content 变量将字符串插入到便笺正文中。

请注意，该文件命名为MyHelpers，但该帮助程序名为 MakeNote。 可以将多个自定义帮助程序放入单个文件中。

保存并关闭文件。

在页面中使用帮助器

在根文件夹中，创建名为TestHelper的新空白文件。

向文件中添加以下代码：

Test Helpers Page

This is some opening paragraph text.

@MyHelpers.MakeNote("My test note content.")

This is some following text.