ASP.NET Web Pages (Razor) API 快速參考

發行項
09/24/2024

此頁面包含一份清單，其中包含使用 Razor 語法對 ASP.NET Web Pages 進行程式設計的最常用物件、屬性和方法的簡要範例。

標示 "(v2)" 的描述是在網頁第 2 版 ASP.NET 導入。

如需 API 參考文件，請參閱 MSDN 上的 ASP.NET Web Pages 參考文件。

軟體版本

ASP.NET Web Pages (Razor) 3

此教學課程也適用於 ASP.NET Web Pages 2 和 ASP.NET Web Pages 2 1.0 (除了標示 v2 的功能除外)。

此頁面包含以下參考資訊：

類別
Data
協助程式
驗證

類別

`AppState[key], AppState[index],App`

包含可由應用程式中任何頁面共用的資料。您可以使用動態 App 屬性存取相同的資料，如下列範例所示：

AppState["FavoriteColor"] = "red";
AppState[1] = "apples";
App.MyGreeting = "Good morning";
// Displays the value assigned to AppData[1] in the page.
@App[1]
// Displays the value assigned to App.MyGreeting.
@App.MyGreeting

`AsBool(), AsBool(true|false)`

將字串值轉換為布林值 (true/false)。如果字串不表示 true/false，則傳回 false 或指定的值。

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

將字串值轉換為日期/時間。如果字串不表示日期/時間，則傳回 DateTime.MinValue 或指定的值。

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

將字串值轉換為十進位值。如果字串不代表十進位值，則傳回 0.0 或指定的值。

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

將字串轉換為浮點數。如果字串不代表十進位值，則傳回 0.0 或指定的值。

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

將字串值轉換為整數。如果字串不代表整數，則傳回 0 或指定的值。

int i = stringValue.AsInt();

`Href(path [, param1 [, param2]])`

從本機檔案路徑建立瀏覽器相容的 URL，以及選擇性的其他路徑組件。

<a href="@Href("~/Folder/File")">Link to My File</a>
<a href="@Href("~/Product", "Tea")">Link to Product</a>

`Html.Raw(value)`

將值轉譯為 HTML 標記，而不是將轉譯為 HTML 編碼的輸出。

@* Inserts markup into the page. *@
@Html.Raw("<div>Hello <em>world</em>!</div>")

`IsBool(), IsDateTime(), IsDecimal(), IsFloat(), IsInt()`

如果值可以從字串轉換成指定的類型，則傳回 true。

var isint = stringValue.IsInt();

`IsEmpty()`

如果物件或變數沒有值，則傳回 true。

if (Request["companyname"].IsEmpty()) {
    @:Company name is required.<br />
}

`IsPost`

如果要求是 POST，則傳回 true。 (初始要求通常是 GET)。

if (IsPost) { Response.Redirect("Posted"); }

`Layout`

指定要套用至此頁面的配置頁面路徑。

Layout = "_MyLayout.cshtml";

`PageData[key], PageData[index],Page`

包含目前要求中頁面、版面配置頁面和部分頁面之間共用的資料。您可以使用動態 Page 屬性存取相同的資料，如下列範例所示：

PageData["FavoriteColor"] = "red";
PageData[1] = "apples";
Page.MyGreeting = "Good morning";
// Displays the value assigned to PageData[1] in the page.
@Page[1]
// Displays the value assigned to Page.MyGreeting.
@Page.MyGreeting

`RenderBody()`

（版面設定頁面）轉譯不在任何具名區段中的內容頁面內容。

@RenderBody()

`RenderPage(path, values)`

RenderPage(path[,param1 [, param2]])

使用指定的路徑和選擇性額外資料來轉譯內容頁面。您可以藉由位置 (範例 1) 或索引鍵 (範例 2) 從 PageData 取得額外參數的值。

RenderPage("_MySubPage.cshtml", "red", 123, "apples")
RenderPage("_MySubPage.cshtml", new { color = "red", number = 123, food = "apples" })

`RenderSection(sectionName [, required = true|false])`

(版面設定頁面) 轉譯具有名稱的內容區段。將必要設定為 false，讓區段變成選擇性。

@RenderSection("header")

`Request.Cookies[key]`

取得或設定 HTTP 的值。

var cookieValue = Request.Cookies["myCookie"].Value;

`Request.Files[key]`

取得在目前要求中上傳的檔案。

Request.Files["postedFile"].SaveAs(@"MyPostedFile");

`Request.Form[key]`

取得以表單發佈的資料 (以字串形式)。 Request[key] 會檢查 Request.Form 和 Request.QueryString 集合。

var formValue = Request.Form["myTextBox"];
// This call produces the same result.
var formValue = Request["myTextBox"];

`Request.QueryString[key]`

取得 URL 查詢字串中指定的資料。 Request[key] 會檢查 Request.Form 和 Request.QueryString 集合。

var queryValue = Request.QueryString["myTextBox"];
// This call produces the same result.
var queryValue = Request["myTextBox"];

`Request.Unvalidated(key)`

Request.Unvalidated().QueryString|Form|Cookies|Headers[key]

選擇性停用表單元素、查詢字串值、Cookie 或標頭值的要求驗證。預設會啟用要求驗證，並防止使用者發佈標記或其他潛在危險內容。

// Call the method directly to disable validation on the specified item from
// one of the Request collections.
Request.Unvalidated("userText");

// You can optionally specify which collection the value is from.
var prodID = Request.Unvalidated().QueryString["productID"];
var richtextValue = Request.Unvalidated().Form["richTextBox1"];
var cookie = Request.Unvalidated().Cookies["mostRecentVisit"];

`Response.AddHeader(name, value)`

將 HTTP 伺服器加入至回應。

// Adds a header that requests client browsers to use basic authentication.
Response.AddHeader("WWW-Authenticate", "BASIC");

`Response.OutputCache(seconds [, sliding] [, varyByParams])`

快取指定時間的頁面輸出。選擇性設定滑動來重設每個頁面存取的逾時，並設定 varyByParams 來快取頁面要求中每個不同查詢字串的不同頁面版本。

Response.OutputCache(60);
Response.OutputCache(3600, true);
Response.OutputCache(10, varyByParams : new[] {"category","sortOrder"});

`Response.Redirect(path)`

將瀏覽器要求重新導向至新位置。

Response.Redirect("~/Folder/File");

`Response.SetStatus(httpStatusCode)`

設定傳送至瀏覽器的 HTTP 狀態程式碼。

Response.SetStatus(HttpStatusCode.Unauthorized);
Response.SetStatus(401);

`Response.WriteBinary(data [, mimetype])`

使用選擇性 MIME 類型將資料的內容寫入回應。

Response.WriteBinary(image, "image/jpeg");

`Response.WriteFile(file)`

將檔案的內容寫入回應。

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(版面設定頁面) 定義具有名稱的內容區段。

@section header { <div>Header text</div> }

`Server.HtmlDecode(htmlText)`

解碼 HTML 編碼的字串。

var htmlDecoded = Server.HtmlDecode("&lt;html&gt;");

`Server.HtmlEncode(text)`

編碼字串以在 HTML 標記中轉譯。

var htmlEncoded = Server.HtmlEncode("<html>");

`Server.MapPath(virtualPath)`

傳回指定虛擬路徑的伺服器實體路徑。

var dataFile = Server.MapPath("~/App_Data/data.txt");

`Server.UrlDecode(urlText)`

從 URL 解碼文字。

var urlDecoded = Server.UrlDecode("url%20data");

`Server.UrlEncode(text)`

編碼要放入 URL 中的文字。

var urlEncoded = Server.UrlEncode("url data");

`Session[key]`

取得或設定存在的值，直到使用者關閉瀏覽器為止。

Session["FavoriteColor"] = "red";

`ToString()`

顯示物件值的字串表示式。

<p>It is now @DateTime.Now.ToString()</p>

`UrlData[index]`

從 URL 取得其他資料 (例如 /MyPage/ExtraData)。

var pathInfo = UrlData[0];

`WebSecurity.ChangePassword(userName,currentPassword,newPassword)`

變更指定之使用者的密碼。

var success = WebSecurity.ChangePassword("my-username",
    "current-password", "new-password");

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

使用帳戶確認權杖確認帳戶。

var confirmationToken = Request.QueryString["ConfirmationToken"];
if(WebSecurity.ConfirmAccount(confirmationToken)) {
      //...
}

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

使用指定的使用者名稱和密碼建立新的使用者帳戶。若要求確認權杖，請針對 requireConfirmationToken 傳遞 true。

WebSecurity.CreateAccount("my-username", "secretpassword");

`WebSecurity.CurrentUserId`

取得目前登入使用者的整數識別碼。

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

取得目前登入使用者的名稱。

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

產生密碼重設權杖，以電子郵件傳送給使用者，讓使用者可以重設密碼。

var resetToken = WebSecurity.GeneratePasswordResetToken("my-username");
var message = "Visit http://example.com/reset-password/" + resetToken +
    " to reset your password";
WebMail.Send(..., message);

`WebSecurity.GetUserId(userName)`

從使用者名稱傳回使用者識別碼。

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

如果目前的使用者已登入，則傳回 true。

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

如果使用者已確認，則會傳回 true (例如，透過確認電子郵件)。

if(WebSecurity.IsConfirmed("joe@contoso.com")) { ... }

`WebSecurity.IsCurrentUser(userName)`

如果目前使用者的名稱符合指定的使用者名稱，則傳回 true。

if(WebSecurity.IsCurrentUser("joe@contoso.com")) { ... }

`WebSecurity.Login(userName,password[, persistCookie])`

在 Cookie 中設定驗證權杖，以登入使用者。

if(WebSecurity.Login("username", "password")) { ... }

`WebSecurity.Logout()`

藉由移除驗證權杖 Cookie 來登出使用者。

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

如果未驗證使用者，請將 HTTP 狀態設定為 401 (未經授權)。

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

如果目前使用者不是其中一個指定角色的成員，請將 HTTP 狀態設定為 401 (未經授權)。

WebSecurity.RequireRoles("Admin", "Power Users");

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

如果目前的使用者不是使用者名稱所指定的使用者，請將 HTTP 狀態設定為 401 (未經授權)。

WebSecurity.RequireUser("joe@contoso.com");

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

如果密碼重設權杖有效，請將使用者的密碼變更為新的密碼。

WebSecurity.ResetPassword( "A0F36BFD9313", "new-password")

資料

`Database.Execute(SQLstatement [,parameters]`

執行 SQLstatement (含選擇性參數)，例如 INSERT、DELETE 或 UPDATE，並傳回受影響的記錄計數。

db.Execute("INSERT INTO Data (Name) VALUES ('Smith')");

db.Execute("INSERT INTO Data (Name) VALUES (@0)", "Smith");

`Database.GetLastInsertId()`

從最近插入的資料列傳回識別資料行。

db.Execute("INSERT INTO Data (Name) VALUES ('Smith')");
var id = db.GetLastInsertId();

`Database.Open(filename)`

Database.Open(connectionStringName)

從 Web.config 檔案使用具名連線字串來開啟指定的資料庫檔案，或指定的資料庫。

// Note that no filename extension is specified.
var db = Database.Open("SmallBakery"); // Opens SmallBakery.sdf in App_Data
// Opens a database by using a named connection string.
var db = Database.Open("SmallBakeryConnectionString");

`Database.OpenConnectionString(connectionString)`

使用連接字串開啟資料庫。 (這與 Database.Open 形成對比，其使用連線字串名稱。

var db = Database.OpenConnectionString("Data Source=|DataDirectory|\SmallBakery.sdf");

`Database.Query(SQLstatement[,parameters])`

使用 SQLstatement 查詢資料庫 (選擇性傳遞參數)，並將結果以集合形式傳回。

foreach (var result in db.Query("SELECT * FROM PRODUCT")) {<p>@result.Name</p>}

foreach (var result = db.Query("SELECT * FROM PRODUCT WHERE Price > @0", 20))
   { <p>@result.Name</p> }

`Database.QuerySingle(SQLstatement [, parameters])`

執行 SQLstatement (含選擇性參數)，並傳回單一記錄。

var product = db.QuerySingle("SELECT * FROM Product WHERE Id = 1");

var product = db.QuerySingle("SELECT * FROM Product WHERE Id = @0", 1);

`Database.QueryValue(SQLstatement [, parameters])`

執行 SQLstatement (含選擇性參數)，並傳回單一值。

var count = db.QueryValue("SELECT COUNT(*) FROM Product");

var count = db.QueryValue("SELECT COUNT(*) FROM Product WHERE Price > @0", 20);

協助程式

`Analytics.GetGoogleHtml(webPropertyId)`

為指定的識別碼轉譯 Google Analytics JavaScript 程式碼。

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

為指定的專案轉譯 StatCounter Analytics JavaScript 程式碼。

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

為指定的帳戶轉譯 Yahoo Analytics JavaScript 程式碼。

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

將搜尋傳遞至 Bing。若要指定要搜尋的網站，以及搜尋方塊的標題，您可以設定 Bing.SiteUrl 和 Bing.SiteTitle 屬性。一般而言，您會在 _AppStart 頁面中設定這些屬性。

@Bing.SearchBox() @* Searches the web.*@

@{
   Bing.SiteUrl = "www.asp.net";  @* Limits search to the www.asp.net site. *@
}
@Bing.SearchBox()

`Chart(width,height [, template] [, templatePath])`

初始化圖表。

@{
   var myChart = new Chart(width: 600, height: 400);
}

`Chart.AddLegend([title] [, name])`

將圖例新增至圖表。

@{
var myChart = new Chart(width: 600, height: 400)
    .AddLegend("Basic Chart")
    .AddSeries(
        name: "Employee",
        xValue: new[] {  "Peter", "Andrew", "Julie", "Mary", "Dave" },
        yValues: new[] { "2", "6", "4", "5", "3" })
    .Write();
}

`Chart.AddSeries([name] [, chartType] [, chartArea]`

[, axisLabel] [, legend] [, markerStep] [, xValue]
[, xField] [, yValues] [, yFields] [, options])

將一系列值加入圖表。

@{
var myChart = new Chart(width: 600, height: 400)
    .AddSeries(
        name: "Employee",
        xValue: new[] {  "Peter", "Andrew", "Julie", "Mary", "Dave" },
        yValues: new[] { "2", "6", "4", "5", "3" })
    .Write();
}

`Crypto.Hash(string [, algorithm])`

Crypto.Hash(bytes [, algorithm])

傳回指定資料的雜湊。預設演算法是 sha256。

@Crypto.Hash("data")

`Facebook.LikeButton(href [, buttonLayout] [, showFaces] [, width] [, height]`

[, action] [, font] [, colorScheme] [, refLabel])

可讓 Facebook 使用者與頁面建立連線。

@Facebook.LikeButton("www.asp.net")

`FileUpload.GetHtml([initialNumberOfFiles] [, allowMoreFilesToBeAdded]`

[, includeFormTag] [, addText] [, uploadText])

轉譯用於上傳檔案的 UI。

@FileUpload.GetHtml(initialNumberOfFiles:1, allowMoreFilesToBeAdded:false,
  includeFormTag:true, uploadText:"Upload")

`GamerCard.GetHtml(gamerTag)`

轉譯指定的 Xbox 玩家標籤。

@GamerCard.GetHtml("joe")

`Gravatar.GetHtml(email [, imageSize] [, defaultImage] [, rating]`

[, imageExtension] [, attributes])

轉譯指定電子郵件位址的 Gravatar 影像。

@Gravatar.GetHtml("joe@contoso.com")

`Json.Encode(object)`

將資料物件轉換成 JavaScript 物件表示法 (JSON) 格式的字串。

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

將 JSON 編碼的輸入字串轉換成資料物件，您可以反覆查看或插入資料庫。

var myJsonObj = Json.Decode(jsonString);

`LinkShare.GetHtml(pageTitle[, pageLinkBack] [, twitterUserName]`

[, additionalTweetText] [, linkSites])

使用指定的標題和選擇性 URL 轉譯社交網路連結。

@LinkShare.GetHtml("ASP.NET Web Pages Samples")
@LinkShare.GetHtml("ASP.NET Web Pages Samples", "http://www.asp.net")

`ModelStateDictionary.AddError(key, errorMessage)`

使錯誤訊息與表單欄位產生關聯。使用 ModelState 協助程式存取此成員。

ModelState.AddError("email", "Enter an email address");

`ModelStateDictionary.AddFormError(errorMessage)`

使錯誤訊息與表單產生關聯。使用 ModelState 協助程式存取此成員。

ModelState.AddFormError("Password and confirmation password do not match.");

`ModelStateDictionary.IsValid`

如果沒有驗證錯誤，則傳回 true。使用 ModelState 協助程式存取此成員。

if (ModelState.IsValid) { // Save the form to the database }

`ObjectInfo.Print(value [, depth] [, enumerationLength])`

轉譯物件和任何子物件的屬性和值。

@ObjectInfo.Print(person)

`Recaptcha.GetHtml([, publicKey] [, theme] [, language] [, tabIndex])`

轉譯 reCAPTCHA 驗證測試。

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

設定 reCAPTCHA 服務的公開金鑰和私密金鑰。一般而言，您會在 _AppStart 頁面中設定這些屬性。

ReCaptcha.PublicKey = "your-public-recaptcha-key";
ReCaptcha.PrivateKey = "your-private-recaptcha-key";

`ReCaptcha.Validate([, privateKey])`

傳回 reCAPTCHA 測試的結果。

if (ReCaptcha.Validate()) {
   // Test passed.
}

`ServerInfo.GetHtml()`

轉譯 ASP.NET Web Pages 的狀態資訊。

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

轉譯指定使用者的 Twitter 串流。

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

轉譯指定搜尋文字的 Twitter 串流。

@Twitter.Search("asp.net")

`Video.Flash(filename [, width, height])`

為具有選擇性寬度和高度的指定檔案轉譯 Flash 影片播放程式。

@Video.Flash("test.swf", "100", "100")

`Video.MediaPlayer(filename [, width, height])`

為具有選擇性寬度和高度的指定檔案轉譯 Windows Media Player。

@Video.MediaPlayer("test.wmv", "100", "100")

`Video.Silverlight(filename, width, height)`

為具有所需寬度和高度之指定的 .xap 檔案轉譯 Silverlight 播放程式。

@Video.Silverlight("test.xap", "100", "100")

`WebCache.Get(key)`

傳回索引鍵所指定的物件，如果找不到物件，則傳回 null。

var username = WebCache.Get("username")

`WebCache.Remove(key)`

從快取移除索引鍵指定的物件。

WebCache.Remove("username")

`WebCache.Set(key, value [, minutesToCache] [, slidingExpiration])`

將值放入索引鍵所指定名稱下的快取。

WebCache.Set("username", "joe@contoso.com ")

`WebGrid(data)`

使用查詢中的資料建立新的 WebGrid 物件。

var db = Database.Open("SmallBakery");
var grid = new WebGrid(db.Query("SELECT * FROM Product"));

`WebGrid.GetHtml()`

轉譯標記以在 HTML 資料表中顯示資料。

@grid.GetHtml()// The 'grid' variable is set when WebGrid is created.

`WebGrid.Pager()`

轉譯 WebGrid 物件的呼叫器。

@grid.Pager() // The 'grid' variable is set when WebGrid is created.

`WebImage(path)`

從指定的路徑載入影像。

var image = new WebImage("test.png");

`WebImage.AddImagesWatermark(image)`

將指定的影像新增為浮水印。

WebImage photo = new WebImage("test.png");
WebImage watermarkImage = new WebImage("logo.png");
photo.AddImageWatermark(watermarkImage);

`WebImage.AddTextWatermark(text)`

將指定的文字新增至影像。

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

水平或垂直翻轉影像。

image.FlipHorizontal();
image.FlipVertical();

`WebImage.GetImageFromRequest()`

在檔案上傳期間將影像張貼到頁面時載入影像。

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

調整影像的大小。

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

將影像向左或向右旋轉。

image.RotateLeft();
image.RotateRight();

`WebImage.Save(path [, imageFormat])`

將影像儲存至指定的路徑。

image.Save("test.png");

`WebMail.Password`

設定 SMTP 伺服器的密碼。通常您會在 _AppStart 頁面中設定此屬性。

WebMail.Password = "password";

`WebMail.Send(to, subject, body [, from] [, cc] [, filesToAttach] [, isBodyHtml]`

[, additionalHeaders])

傳送電子郵件訊息。

WebMail.Send("touser@contoso.com", "subject", "body of message",
    "fromuser@contoso.com");

`WebMail.SmtpServer`

設定 SMTP 伺服器名稱。通常您會在 _AppStart 頁面中設定此屬性。

WebMail.SmtpServer = "smtp.mailserver.com";

`WebMail.UserName`

設定 SMTP 伺服器的使用者名稱。通常您應該在 _AppStart 頁面中設定此屬性。

WebMail.UserName = "Joe";

驗證

`Html.ValidationMessage(field)`

(v2) 轉譯指定欄位的驗證錯誤訊息。

<input type="text"
    name="dateOfBirth"
    value="" />
@Html.ValidationMessage("dateOfBirth")

`Html.ValidationSummary([message])`

(v2) 顯示所有驗證錯誤的清單。

@Html.ValidationSummary()

@Html.ValidationSummary("The following validation errors occurred:")

`Validation.Add(field, validationType)`

(v2) 為指定的驗證類型註冊使用者輸入元素。

Validation.Add("dateOfBirth", Validator.DateTime("Date of birth was not valid"));
Validation.Add("quantity", Validator.Integer("Enter a number"));
Validation.Add("confirmPassword",
    Validator.EqualsTo("password", "Passwords must match."));

`Validation.ClassFor(field)`

(v2) 動態轉譯用戶端驗證的 CSS 類別屬性，讓您可以格式化驗證錯誤訊息。 (要求您參考適當的用戶端指令碼程式庫，以及定義 CSS 類別)。

<head>
  <script
    src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.6.2.js">
  </script>
  <script
    src="https://ajax.aspnetcdn.com/ajax/jquery.validate/1.8.1/jquery.validate.js">
  </script>
  <script
    src="~/Scripts/jquery.validate.unobtrusive.js">
  </script>

  <style>
    input-validation-error{ /* style rules  */ }
    field-validation-error{ /* style rules  */ }
    validation-summary-errors{ /* style rules  */ }
    field-validation-valid{ /* style rules  */ }
    input-validation-valid{ /* style rules  */ }
    validation-summary-valid{ /* style rules  */ }
  </style>
</head>

...

<input
    type="text"
    name="firstName"
    @Validation.For("firstName") @Validation.ClassFor("firstName")  />

`Validation.For(field)`

(v2) 針對使用者輸入欄位啟用的用戶端驗證。 (要求您參考適當的用戶端指令碼程式庫)。

<head>
  <script
    src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.6.2.js">
  </script>
  <script
    src="https://ajax.aspnetcdn.com/ajax/jquery.validate/1.8.1/jquery.validate.js">
  </script>
  <script
    src="~/Scripts/jquery.validate.unobtrusive.js">
  </script>
</head>

...

<input
    type="text"
    name="firstName"
    @Validation.For("firstName") />

`Validation.IsValid()`

(v2) 如果為驗證註冊的所有使用者輸入元素包含有效值，則傳回 true。

if(IsPost){
    if (Validation.IsValid()) {
        // Process input
    }
}

`Validation.RequireField(field[, errorMessage])`

(v2) 指定使用者必須提供使用者輸入元素的值。

Validation.RequireField("dateOfBirth", "Date of birth is required");

`Validation.RequireFields(field1[, field12, field3, ...])`

(v2) 指定使用者必須為每個使用者輸入元素提供值。這個方法不會讓您指定自訂錯誤訊息。

Validation.RequireFields("firstName", "lastName", "dateOfBirth");

`Validator.DateTime ([error message])`

Validator.Decimal([error message])
Validator.EqualsTo(otherField,[error message])
Validator.Float([error message])
Validator.Integer([error message])
Validator.Range(min,max [, error message])
Validator.RegEx(pattern[, error message])
Validator.Required([error message])
Validator.StringLength(length)
Validator.Url([error message])

(v2) 當您使用 Validation.Add 方法時，指定驗證測試。

Validation.Add("dateOfBirth", Validator.DateTime("Date of birth was not valid"));
Validation.Add("quantity", Validator.Integer("Enter a number"));
Validation.Add("confirmPassword", Validator.EqualsTo("password",
    "Passwords must match."));

共用方式為

ASP.NET Web Pages (Razor) API 快速參考

軟體版本

類別

AppState[key], AppState[index],App

AsBool(), AsBool(true|false)

AsDateTime(), AsDateTime(value)

AsDecimal(), AsDecimal(value)

AsFloat(), AsFloat(value)

AsInt(), AsInt(value)

Href(path [, param1 [, param2]])

Html.Raw(value)

IsBool(), IsDateTime(), IsDecimal(), IsFloat(), IsInt()

IsEmpty()

IsPost

Layout

PageData[key], PageData[index],Page

RenderBody()

RenderPage(path, values)

RenderSection(sectionName [, required = true|false])

Request.Cookies[key]

Request.Files[key]

Request.Form[key]

Request.QueryString[key]

Request.Unvalidated(key)

Response.AddHeader(name, value)

Response.OutputCache(seconds [, sliding] [, varyByParams])

Response.Redirect(path)

Response.SetStatus(httpStatusCode)

Response.WriteBinary(data [, mimetype])

Response.WriteFile(file)

@section(sectionName) {content }

Server.HtmlDecode(htmlText)

Server.HtmlEncode(text)

Server.MapPath(virtualPath)

Server.UrlDecode(urlText)

Server.UrlEncode(text)

Session[key]

ToString()

UrlData[index]

WebSecurity.ChangePassword(userName,currentPassword,newPassword)

WebSecurity.ConfirmAccount(accountConfirmationToken)

WebSecurity.CreateAccount(userName, password

WebSecurity.CurrentUserId

WebSecurity.CurrentUserName

WebSecurity.GeneratePasswordResetToken(username

WebSecurity.GetUserId(userName)

WebSecurity.IsAuthenticated

WebSecurity.IsConfirmed(userName)

WebSecurity.IsCurrentUser(userName)

WebSecurity.Login(userName,password[, persistCookie])

WebSecurity.Logout()

WebSecurity.RequireAuthenticatedUser()

WebSecurity.RequireRoles(roles)

WebSecurity.RequireUser(userId)

WebSecurity.ResetPassword(passwordResetToken,newPassword)

資料

Database.Execute(SQLstatement [,parameters]

Database.GetLastInsertId()

Database.Open(filename)

Database.OpenConnectionString(connectionString)

Database.Query(SQLstatement[,parameters])

Database.QuerySingle(SQLstatement [, parameters])

Database.QueryValue(SQLstatement [, parameters])