Web Pages 快速入门

Web Pages 是三种创建 ASP.NET 网站和 Web 应用程序的编程模式中的一种。

其他两种编程模式是 Web Forms 和 MVC（Model View Controller 模型-视图-控制器）。

主要的 Razor C# 语法规则

• Razor 代码块包含在 @{ ... } 中
• 内联表达式（变量和函数）以 @ 开头
• 代码语句用分号结束
• 变量使用 var 关键字声明
• 字符串用引号括起来
• C# 代码区分大小写
• C# 文件的扩展名是 .cshtml

使用 @RenderPage() 方法从不同的文件导入内容。如@RenderPage("footer.cshtml")

使用 @RenderBody() 方法嵌入内容页 

@{Layout="Layout.cshtml";}

ASP.NET 类参考手册

方法	描述
AsBool(), AsBool(true|false)	转换字符串值为布尔值（true/false）。如果字符串不能转换为true/false，则返回 false 或者其他规定的值。
AsDateTime(), AsDateTime(value)	转换字符串值为日期/时间。返回 DateTime。如果字符串不能转换为日期/时间，则返回 MinValue 或者其他规定的值。
AsDecimal(), AsDecimal(value)	转换字符串值为十进制值。如果字符串不能转换为十进制值，则返回 0.0 或者其他规定的值。
AsFloat(), AsFloat(value)	转换字符串值为浮点数。如果字符串不能转换为浮点数，则返回 0.0 或者其他规定的值。
AsInt(), AsInt(value)	转换字符串值为整数。如果字符串不能转换成整数，则返回 0 或者其他规定的值。
Href(path [, param1 [, param2]])	从带有可选的附加路径部分的本地文件路径创建一个浏览器兼容的 URL。
Html.Raw(value)	Rendersvalue 呈现为 HTML 标记，而不是呈现为 HTML 编码输出。
IsBool(), IsDateTime(), IsDecimal(), IsFloat(), IsInt()	如果该值可以从字符串转换为指定的类型，则返回 true。
IsEmpty()	如果对象或者变量没有值，则返回 true。
IsPost	如果请求是 POST，则返回 true。（初始请求通常是 GET。）
Layout	规定布局页面的路径应用到此页面。
PageData[key], PageData[index], Page	在当前请求的页面、布局页面、部分页面之间包含共享数据。您可以使用动态页面来对相同的数据进行属性访问。
RenderBody()	(Layout pages) 呈现没有在布局页面任何命名区域的内容页的内容Renders the content of a content page that is not in any named sections.
RenderPage(path, values) RenderPage(path[, param1 [, param2]])	呈现使用了规定的路径和可选的额外数据的内容页。您可以通过 position（实例 1）或者 key（实例 2）从 PageData 获取额外参数的值。
RenderSection(sectionName [, required = true|false])	(Layout pages) 呈现一个有名字的内容区域。设置 required 让一个区域为必需非可选的。
Request.Cookies[key]	获取或者设置 HTTP cookie 的值。
Request.Files[key]	Gets 在当前请求中上传的文件。
Request.Form[key]	获取在表单中 post 的数据（作为字符串）。Request.Form 和 Request.QueryString 都要求[key] 检查。
Request.QueryString[key]	获取 URL 查询字符串中规定的数据。Request.Form 和 Request.QueryString 都要求[key] 检查。
Request.Unvalidated(key) Request.Unvalidated().QueryString|Form|Cookies|Headers[key]	有选择地禁用请求验证（表单元素、查询字符串值、cookie、header 值）。请求验证默认是开启的，防止用户提交标记或者其他潜在的危险内容。
Response.AddHeader(name, value)	在应答中添加一个 HTTP 服务器响应头。
Response.OutputCache(seconds [, sliding] [, varyByParams])	Caches 在指定时间的页面输出缓存。设置 sliding 来重置每个页面的访问超时时间，设置 varyByParams 为请求页面的每个不同的查询字符串缓存不同版本的页面。
Response.Redirect(path)	重定向浏览器请求到一个新的位置。
Response.SetStatus(httpStatusCode)	设置HTTP状态代码发送到浏览器。
Response.WriteBinary(data [, mimetype])	写入 data 内容响应可选的MIME类型。
Response.WriteFile(file)	写入文件内容响应。
@section(sectionName) { content }	（布局页面）定义一个有名字的内容区域。
Server.HtmlDecode(htmlText)	解码一个HTML编码的字符串。
Server.HtmlEncode(text)	为呈现在 HTML 标记中的字符串编码。
Server.MapPath(virtualPath)	为指定的虚拟路径返回服务器的物理路径。
Server.UrlDecode(urlText)	解码URL文本。
Server.UrlEncode(text)	URL文本编码。
Session[key]	获取或设置一个存在的值，直到用户关闭浏览器。
ToString()	显示一个用字符串表示的对象的值。
UrlData[index]	从 URL 获取额外的数据（例如，/MyPage/ExtraData）。

某些 Page 对象属性

属性	描述
isPost	如果客户端使用的 HTTP 数据传输方法是 POST 请求，则返回 true。
Layout	获取或者设置布局页面的路径。
Page	提供了对页面和布局页之间共享的数据的类似属性访问。
Request	为当前的 HTTP 请求获取 HttpRequest 对象。
Server	获取 HttpServerUtility 对象，该对象提供了网页处理方法。

 

WebSecurity 对象提供 ASP.NET Web Pages 应用程序的安全性和认证。

ASP.NET Database 对象参考手册

---

方法	描述
Database.Execute(SQLstatement [,parameters])	执行 SQL 语句 SQLstatement（带可选参数），比如 INSERT、DELETE 或者 UPDATE， 并且返回受影响的记录统计。
Database.GetLastInsertId()	返回最近插入行的标识列。
Database.Open(filename) Database.Open(connectionStringName)	使用 Web.config 文件中的连接字符串打开指定的数据库文件或者指定的数据库。
Database.OpenConnectionString(connectionString)	使用连接字符串打开一个数据库。（与 Database.Open 的差异是，Database.Open 使用的是连接字符串的名称，连接字符串的值在其他地方配置。）
Database.Query(SQLstatement[, parameters])	使用 SQL 语句 SQLstatement（带可选参数）查询数据库，并返回结果集合。
Database.QuerySingle(SQLstatement[, parameters])	执行 SQL 语句 SQLstatement（带可选参数），并返回单条记录。
Database.QueryValue(SQLstatement[, parameters])	执行 SQL 语句 SQLstatement（带可选参数），并返回单个值。

WebMail 对象参考手册 - 属性

属性	描述
SmtpServer	用于发送电子邮件的 SMTP 服务器的名称。
SmtpPort	服务器用来发送 SMTP 电子邮件的端口。
EnableSsl	如果服务器使用 SSL（Secure Socket Layer 安全套接层）加密，则值为 true。
UserName	用于发送电子邮件的 SMTP 电子邮件账户的名称。
Password	SMTP 电子邮件账户的密码。
From	在发件地址栏显示的电子邮件（通常与 UserName 相同）。

---

WebMail 对象参考手册 - 方法

方法	描述
Send()	向 SMTP 服务器发送需要传送的电子邮件信息。

Send() 方法有以下参数：

参数	类型	描述
to	String	收件人（用分号分隔）
subject	String	邮件主题
body	String	邮件正文

Send() 方法有以下可选参数：

参数	类型	描述
from	String	发件人
cc	String	需要抄送的电子邮件地址（用分号分隔）
filesToAttach	Collection	附件名
isBodyHtml	Boolean	如果邮件正文是 HTML 格式的，则为 true
additionalHeaders	Collection	附加的标题

ASP.NET Web Pages - 更多帮助器

Analytics 对象参考手册（Google）

Helper	描述
Analytics.GetGoogleHtml(webPropertyId)	为指定的 ID 呈现 Google Analytics JavaScript 代码。
Analytics.GetStatCounterHtml(project,security)	为指定的项目呈现 StatCounter Analytics JavaScript 代码。
Analytics.GetYahooHtml(account)	为指定的账号呈现 Yahoo Analytics JavaScript 代码。

---

Bing 对象参考手册

Helper	描述
Bing.SearchBox([boxWidth])	给 Bing 传递搜索。您可以设置 Bing.SiteUrl 和 Bing.SiteTitle 属性来设定站点搜索和搜索框的标题，通常是在 _AppStart 页面设置这些属性。
Bing.AdvancedSearchBox([, boxWidth] [, resultWidth] [, resultHeight] [, themeColor] [, locale])	用可选的格式显示 Bing 搜索结果在页面上。您可以设置 Bing.SiteUrl 和 Bing.SiteTitle 属性来设定站点搜索和搜索框的标题，通常是在 _AppStart 页面设置这些属性。

---

Chart 对象参考手册

Helper	描述
Chart(width, height [, template] [, templatePath])	初始化图表。
Chart.AddLegend([title] [, name])	给图表添加一个图例。
Chart.AddSeries([name] [, chartType] [, chartArea] [, axisLabel] [, legend] [, markerStep] [, xValue] [, xField] [, yValues] [, yFields] [, options])	给图表添加一系列数据。

---

Crypto 对象参考手册

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

---

Facebook 对象参考手册

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

---

FileUpload 对象参考手册

Helper	描述
FileUpload.GetHtml([initialNumberOfFiles] [, allowMoreFilesToBeAdded] [, includeFormTag] [, addText] [,uploadText])	为上传文件呈现 UI。

---

GamerCard 对象参考手册

Helper	描述
GamerCard.GetHtml(gamerTag)	呈现指定的 Xbox gamer 标签。

---

Gravatar 对象参考手册

Helper	描述
Gravatar.GetHtml(email [, imageSize] [, defaultImage] [, rating] [, imageExtension] [, attributes])	为指定的电子邮件地址呈现 Gravatar 图像。

---

Json 对象参考手册

Helper	描述
Json.Encode(object)	用 JavaScript Object Notation (JSON) 把数据对象转换为字符串。
Json.Decode(string)	转换 JSON 编码的输入字符串为您指定的数据对象。

---

LinkShare 对象参考手册

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

---

ModelState 对象参考手册

Helper	描述
ModelStateDictionary.AddError(key,errorMessage)	关联错误信息和一个表单域。使用 ModelState 帮助器访问成员。
ModelStateDictionary.AddFormError(errorMessage)	关联错误信息和一个表单。使用 ModelState 帮助器访问成员。
ModelStateDictionary.IsValid	如果没有验证错误，返回 true。使用 ModelState 帮助器访问成员。

---

ObjectInfo 对象参考手册

Helper	描述
ObjectInfo.Print(value [, depth] [, enumerationLength])	呈现一个对象和所有子对象的属性和值。

---

Recaptcha 对象参考手册

Helper	描述
Recaptcha.GetHtml([, publicKey] [, theme] [, language] [, tabIndex])	呈现 reCAPTCHA 验证测试。
ReCaptcha.PublicKey ReCaptcha.PrivateKey	设置 reCAPTCHA 服务的公共和私有密钥。通常是在 _AppStart 页面设置这些属性。
ReCaptcha.Validate([, privateKey])	返回 reCAPTCHA 测试结果。
ServerInfo.GetHtml()	Renders 呈现有关 ASP.NET Web Pages 的状态信息。

---

Twitter 对象参考手册

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

---

Video 对象参考手册

Helper	描述
Video.Flash(filename [, width, height])	为指定的文件呈现宽度和高度可选的 Flash 视频播放。
Video.MediaPlayer(filename [, width, height])	为指定的文件呈现宽度和高度可选 的 Windows Media 播放器。
Video.Silverlight(filename, width, height)	为指定的 .xap 文件呈现所需的宽度和高度 的 Silverlight 播放器。

---

WebCache 对象参考手册

Helper	描述
WebCache.Get(key)	通过 key 返回指定的对象，如果对象未找到则返回 null。
WebCache.Remove(key)	通过 key 从缓存中删除指定的对象。
WebCache.Set(key, value [, minutesToCache] [, slidingExpiration])	通过 key 把 value 放置到指定名称的缓存中。

---

WebGrid 对象参考手册

Helper	描述
WebGrid(data)	Creates a 使用查询数据创建一个新的 WebGrid 对象。
WebGrid.GetHtml()	Renders markup 显示数据在 HTML 表格中。
WebGrid.Pager()	为 WebGrid 对象呈现一个页面。

---

WebImage 对象参考手册

Helper	描述
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])	保存图像到指定路径。