Web Pages 快速入门

来源：互联网发布：java 网校系统编辑：程序博客网时间：2024/05/22 15:46

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 电子邮件账户的名称。PasswordSMTP 电子邮件账户的密码。From在发件地址栏显示的电子邮件（通常与 UserName 相同）。

WebMail 对象参考手册 - 方法

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

Send() 方法有以下参数：

参数类型描述toString收件人（用分号分隔）subjectString邮件主题bodyString邮件正文

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

参数类型描述fromString发件人ccString需要抄送的电子邮件地址（用分号分隔）filesToAttachCollection附件名isBodyHtmlBoolean如果邮件正文是 HTML 格式的，则为 trueadditionalHeadersCollection附加的标题

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

0 0