ASP.NET 网页助手

Web Helpers 网页助手极大地简化了 web 开发和常见的编程任务。


ASP.NET 助手

ASP.NET 助手是通过几行简单的 Razor 代码即可访问的组件。

您可以使用存放在 .cshtml 文件中的 Razor 语法构建自己的助手,或者使用内建的 ASP.NET 助手。

您将在本教程接下来的章节中学习如何使用 Razor 助手。

下面是对一些有用的 Razor 助手的简要描述:


WebGrid 助手

WebGrid 助手简化了显示数据的方法:

  • 自动建立显示数据的 HTML 表格
  • 支持不同的格式化选项
  • 支持对数据的分页(第一页、下一页、上一页、最后一页)
  • 支持通过点击列标题进行排序

Chart 助手

Chart 助手能够显示出带有不同格式选项和标记的不同类型的图表图片。

chart chart

Chart 助手能够显示数组、数据库或文件中的数据。


WebMail 助手

WebMail 助手提供了使用 SMTP (Simple Mail Transfer Protocol) 来发送电邮消息的功能。


WebImage 助手

WebImage 助手提供了在网页中管理图片的功能。

关键词:剪裁、旋转、调整尺寸、水印。



第三方助手

通过 Razor,您能够利用内建的第三方助手来简化对电邮、数据库、多媒体和社交网络的使用,以及许多其他的问题比如导航和网络安全。


Analytics (Google)

助手 描述
Analytics.GetGoogleHtml(webPropertyId)呈现指定 ID 的 Google Analytics JavaScript 代码。
Analytics.GetStatCounterHtml(project,security)呈现指定项目的 StatCounter Analytics JavaScript 代码。
Analytics.GetYahooHtml(account)呈现指定帐户的 Yahoo Analytics JavaScript 代码。

Bing

助手 描述
Bing.SearchBox([boxWidth])将搜索传递给 Bing。 要指定要搜索的站点和搜索框的标题,可以设置 Bing.SiteUrl 和 Bing.SiteTitle 属性。 通常您在 _AppStart 页面中设置这些属性。
Bing.AdvancedSearchBox([, boxWidth] [, resultWidth] [, resultHeight]
[, themeColor] [, locale]
)
显示必应 使用可选格式在页面中搜索结果。 要指定要搜索的站点和搜索框的标题,可以设置 Bing.SiteUrl 和 Bing.SiteTitle 属性。 通常您在_AppStart 页面中设置这些属性。

Crypto

助手 描述
Crypto.Hash(string [, algorithm])
Crypto.Hash(bytes [, algorithm])
返回指定数据的哈希值。 默认算法是sha256。

Facebook

助手 描述
Facebook.LikeButton(href [, buttonLayout] [, showFaces] [, width] [, height]
[, action] [, font] [, colorScheme] [, refLabel]
)
让 Facebook 用户连接到页面。

FileUpload

助手 描述
FileUpload.GetHtml([initialNumberOfFiles] [, allowMoreFilesToBeAdded]
[
, includeFormTag] [, addText] [ ,uploadText])
呈现用于上传文件的 UI。

GamerCard

助手 描述
GamerCard.GetHtml(gamerTag)渲染指定的 Xbox 玩家标签。

Gravatar 对象参考

助手 描述
Gravatar.GetHtml(email [, imageSize] [, defaultImage] [, rating]
[, imageExtension] [, attributes]
)
渲染 指定电子邮件地址的 Gravatar 图像。

Json

td>
助手 描述
Json.Encode(object)将数据对象转换为 JavaScript Object Notation (JSON) 格式的字符串。
Json.Decode(string)将 JSON 编码的输入字符串转换为可以迭代或插入数据库的数据对象。

LinkShare

助手 描述
LinkShare.GetHtml(pageTitle [, pageLinkBack] [, twitterUserName]
[, additionalTweetText] [, linkSites]
)
使用社交网络链接 指定的标题和可选的 URL。

ModelState

助手 描述
ModelStateDictionary.AddError(key,errorMessage)将错误消息与表单字段相关联。 使用 ModelState 帮助程序访问此成员。
ModelStateDictionary.AddFormError(errorMessage)将错误消息与表单相关联。 使用 ModelState 帮助程序访问此成员。
ModelStateDictionary.IsValid如果没有验证错误,则返回 true。 使用 ModelState 帮助程序访问此成员。

ObjectInfo

助手 描述
ObjectInfo.Print(value [, depth] [, enumerationLength])渲染对象和任何子对象的属性和值。

Recaptcha

助手 描述
Recaptcha.GetHtml([, publicKey] [, theme] [, language] [, tabIndex])渲染 reCAPTCHA 验证测试。
ReCaptcha.PublicKey
ReCaptcha.PrivateKey
为 reCAPTCHA 服务设置公钥和私钥。 通常您在 _AppStart 页面中设置这些属性。
ReCaptcha.Validate([, privateKey])返回reCAPTCHA测试的结果。

ServerInfo

助手 描述
ServerInfo.GetHtml()呈现有关 ASP.NET 网页的状态信息。

Twitter

助手 描述
Twitter.Profile(twitterUserName)为指定用户呈现 Twitter 流。
Twitter.Search(searchQuery)为指定的搜索文本呈现 Twitter 流。

Video

助手 描述
Video.Flash(filename [, width, height])为具有可选宽度和高度的指定文件渲染一个 Flash 视频播放器。
Video.MediaPlayer(filename [, width, height])为具有可选宽度和高度的指定文件渲染一个 Windows Media 播放器。
Video.Silverlight(filename, width, height)为 指定具有所需宽度和高度的 .xap 文件。

WebCache

助手 描述
WebCache.Get(key)返回key指定的对象,如果找不到对象,则返回null。
WebCache.Remove(key)从缓存中移除key指定的对象。
WebCache.Set(key, value [, minutesToCache] [, rollingExpiration])Puts valuekey 指定的名称放入缓存中。

WebImage

助手 描述
WebImage(path)从指定路径加载图片。
WebImage.AddImagesWatermark(image)将指定的图片添加为水印。
WebImage.AddTextWatermark(text)给图片添加指定的文字。
WebImage.FlipHorizontal()
WebImage.FlipVertical()
水平或垂直翻转图像。
WebImage.GetImageFromRequest()在文件上传期间将图像发布到页面时加载图像。
WebImage.Resize(width,height)调整图片大小。
WebImage.RotateLeft()
WebImage.RotateRight()
向左或向右旋转图像。
WebImage.Save(path [, imageFormat])将图片保存到指定路径。