ASP.NET Web Pages (Razor) API – stručná referenční příručka

Článek
2023-07-13

Tato stránka obsahuje seznam se stručnými příklady nejčastěji používaných objektů, vlastností a metod pro programování ASP.NET webových stránek pomocí syntaxe Razor.

Popisy označené "(v2)" byly zavedeny v ASP.NET webové stránky verze 2.

Referenční dokumentaci k rozhraní API najdete v referenční dokumentaci k webovým stránkám ASP.NET na webu MSDN.

Verze softwaru

ASP.NET Webové stránky (Razor) 3

Tento kurz funguje také s ASP.NET Web Pages 2 a ASP.NET Web Pages 1.0 (s výjimkou funkcí označených jako v2).

Tato stránka obsahuje referenční informace k následujícím informacím:

Třídy
Data
Pomocníci
Ověřování

Třídy

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

Obsahuje data, která mohou být sdílena libovolnými stránkami v aplikaci. Dynamickou App vlastnost můžete použít pro přístup ke stejným datům jako v následujícím příkladu:

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)`

Převede řetězcovou hodnotu na logickou hodnotu (true/false). Vrátí hodnotu false nebo zadanou hodnotu, pokud řetězec nepředstavuje hodnotu true/false.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Převede řetězcovou hodnotu na datum a čas. Vrátí DateTime.MinValue hodnotu nebo zadanou hodnotu, pokud řetězec nepředstavuje datum a čas.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Převede řetězcovou hodnotu na desítkovou hodnotu. Vrátí hodnotu 0,0 nebo zadanou hodnotu, pokud řetězec nepředstavuje desetinnou hodnotu.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Převede řetězcovou hodnotu na float. Vrátí hodnotu 0,0 nebo zadanou hodnotu, pokud řetězec nepředstavuje desetinnou hodnotu.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Převede řetězcovou hodnotu na celé číslo. Vrátí hodnotu 0 nebo zadanou hodnotu, pokud řetězec nepředstavuje celé číslo.

int i = stringValue.AsInt();

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

Vytvoří adresu URL kompatibilní s prohlížečem z místní cesty k souboru s volitelnými dalšími částmi cesty.

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

`Html.Raw(value)`

Vykreslí hodnotu jako kód HTML, místo aby ji vykreslila jako výstup kódovaný ve formátu HTML.

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

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

Vrátí hodnotu true, pokud je možné hodnotu převést z řetězce na zadaný typ.

var isint = stringValue.IsInt();

`IsEmpty()`

Vrátí hodnotu true, pokud objekt nebo proměnná nemá žádnou hodnotu.

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

`IsPost`

Vrátí hodnotu true, pokud je požadavek POST. (Počáteční požadavky jsou obvykle get.)

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

`Layout`

Určuje cestu stránky rozložení, která se má použít pro tuto stránku.

Layout = "_MyLayout.cshtml";

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

Obsahuje data sdílená mezi stránkou, stránkami rozložení a částečnými stránkami v aktuálním požadavku. Dynamickou Page vlastnost můžete použít pro přístup ke stejným datům jako v následujícím příkladu:

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()`

(Stránky rozložení) Vykreslí obsah stránky obsahu, která není v žádném pojmenovaném oddílu.

@RenderBody()

`RenderPage(path, values)`

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

Vykreslí stránku obsahu pomocí zadané cesty a volitelných dodatečných dat. Hodnoty parametrů navíc můžete získat z PageData pozice (příklad 1) nebo klíče (příklad 2).

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

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

(Stránky rozložení) Vykreslí oddíl obsahu, který má název. Pokud chcete, aby byl oddíl nepovinný, nastavte možnost Požadováno na false.

@RenderSection("header")

`Request.Cookies[key]`

Získá nebo nastaví hodnotu souboru HTTP cookie.

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

`Request.Files[key]`

Získá soubory, které byly odeslány v aktuálním požadavku.

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

`Request.Form[key]`

Získá data, která byla zaúčtována ve formuláři (jako řetězce). Request[key] zkontroluje jak kolekce Request.FormRequest.QueryString , tak i kolekce.

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

`Request.QueryString[key]`

Získá data, která byla zadána v řetězci dotazu adresy URL. Request[key] zkontroluje jak kolekce Request.FormRequest.QueryString , tak i kolekce.

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]

Selektivně zakáže ověřování požadavků pro element formuláře, hodnotu řetězce dotazu, soubor cookie nebo hodnotu hlavičky. Ověření požadavku je ve výchozím nastavení povolené a brání uživatelům v publikování revizí nebo jiného potenciálně nebezpečného obsahu.

// 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)`

Přidá do odpovědi hlavičku serveru HTTP.

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

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

Po určitou dobu ukládá výstup stránky do mezipaměti. Volitelně můžete nastavit posuvné resetování časového limitu pro přístup ke každé stránce a nastavení varyByParams tak, aby se různé verze stránky pro každý řetězec dotazu v požadavku na stránku uklaly do mezipaměti.

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

`Response.Redirect(path)`

Přesměruje požadavek prohlížeče do nového umístění.

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

`Response.SetStatus(httpStatusCode)`

Nastaví stavový kód HTTP odeslaný do prohlížeče.

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

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

Zapíše obsah dat do odpovědi s volitelným typem MIME.

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

`Response.WriteFile(file)`

Zapíše obsah souboru do odpovědi.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Stránky rozložení) Definuje oddíl obsahu, který má název.

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

`Server.HtmlDecode(htmlText)`

Dekóduje řetězec kódovaný ve formátu HTML.

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

`Server.HtmlEncode(text)`

Zakóduje řetězec pro vykreslování ve značkách HTML.

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

`Server.MapPath(virtualPath)`

Vrátí fyzickou cestu serveru pro zadanou virtuální cestu.

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

`Server.UrlDecode(urlText)`

Dekóduje text z adresy URL.

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

`Server.UrlEncode(text)`

Zakóduje text, který se má vložit do adresy URL.

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

`Session[key]`

Získá nebo nastaví hodnotu, která existuje, dokud uživatel nezavře prohlížeč.

Session["FavoriteColor"] = "red";

`ToString()`

Zobrazí řetězcovou reprezentaci hodnoty objektu.

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

`UrlData[index]`

Získá další data z adresy URL (například /MyPage/ExtraData).

var pathInfo = UrlData[0];

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

Změní heslo pro zadaného uživatele.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Potvrdí účet pomocí potvrzovací tokenu účtu.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Vytvoří nový uživatelský účet se zadaným uživatelským jménem a heslem. Pokud chcete vyžadovat potvrzovací token, předejte hodnotu true pro requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Získá celočíselný identifikátor pro aktuálně přihlášeného uživatele.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Získá jméno pro aktuálně přihlášeného uživatele.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Vygeneruje token pro resetování hesla, který lze odeslat e-mailem uživateli, aby uživatel mohl resetovat heslo.

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)`

Vrátí ID uživatele z uživatelského jména.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Vrátí hodnotu true, pokud je aktuální uživatel přihlášený.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Vrátí hodnotu true, pokud byl uživatel potvrzen (například prostřednictvím potvrzovací e-mailu).

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

`WebSecurity.IsCurrentUser(userName)`

Vrátí hodnotu true, pokud jméno aktuálního uživatele odpovídá zadanému uživatelskému jménu.

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

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

Přihlásí uživatele nastavením ověřovacího tokenu v souboru cookie.

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

`WebSecurity.Logout()`

Odhlásí uživatele odebráním souboru cookie ověřovacího tokenu.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Pokud uživatel není ověřený, nastaví stav HTTP na 401 (Neautorizováno).

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Pokud aktuální uživatel není členem žádné ze zadaných rolí, nastaví stav HTTP na 401 (Neautorizováno).

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Pokud aktuální uživatel není uživatelem určeným uživatelským jménem, nastaví stav HTTP na 401 (Neautorizováno).

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Pokud je token pro resetování hesla platný, změní se heslo uživatele na nové heslo.

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

Data

`Database.Execute(SQLstatement [,parameters]`

Spustí příkaz SQLstatement (s volitelnými parametry), jako jsou INSERT, DELETE nebo UPDATE, a vrátí počet ovlivněných záznamů.

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

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

`Database.GetLastInsertId()`

Vrátí sloupec identity z naposledy vloženého řádku.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Otevře zadaný soubor databáze nebo databázi určenou pomocí pojmenovaného připojovacího řetězce ze souboruWeb.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)`

Otevře databázi pomocí připojovacího řetězce. (To je v kontrastu s Database.Open, který používá název připojovacího řetězce.)

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

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

Dotazuje databázi pomocí funkce SQLstatement (volitelně předání parametrů) a vrátí výsledky jako kolekci.

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])`

Spustí SQLstatement (s volitelnými parametry) a vrátí jeden záznam.

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])`

Spustí SQLstatement (s volitelnými parametry) a vrátí jednu hodnotu.

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

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

Pomocníci

`Analytics.GetGoogleHtml(webPropertyId)`

Vykreslí kód Google Analytics JavaScript pro zadané ID.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Vykreslí javascriptový kód StatCounter Analytics pro zadaný projekt.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Vykreslí kód Yahoo Analytics JavaScript pro zadaný účet.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Předá hledání Bingu. Pokud chcete určit web, který se má hledat, a název vyhledávacího pole, můžete nastavit Bing.SiteUrl vlastnosti a Bing.SiteTitle . Obvykle se tyto vlastnosti nastavují na stránce _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])`

Inicializuje graf.

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

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

Přidá do grafu legendu.

@{
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])

Přidá do grafu řadu hodnot.

@{
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])

Vrátí hodnotu hash pro zadaná data. Výchozí algoritmus je sha256.

@Crypto.Hash("data")

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

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

Umožňuje uživatelům Facebooku vytvářet připojení ke stránkám.

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

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

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

Vykreslí uživatelské rozhraní pro nahrávání souborů.

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

`GamerCard.GetHtml(gamerTag)`

Vykreslí zadanou značku hráče xboxu.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Vykreslí obrázek Gravatar pro zadanou e-mailovou adresu.

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

`Json.Encode(object)`

Převede datový objekt na řetězec ve formátu JSON (JavaScript Object Notation).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Převede vstupní řetězec kódovaný json na datový objekt, který můžete iterovat nebo vložit do databáze.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Vykreslí odkazy na sociální sítě pomocí zadaného názvu a volitelné adresy URL.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Přidruží chybovou zprávu k poli formuláře. Pro přístup k tomuto členu ModelState použijte pomocnou rutinu.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Přidruží chybovou zprávu k formuláři. Pro přístup k tomuto členu ModelState použijte pomocnou rutinu.

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

`ModelStateDictionary.IsValid`

Vrátí hodnotu true, pokud nedojde k žádným chybám ověření. Pro přístup k tomuto členu ModelState použijte pomocnou rutinu.

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

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

Vykreslí vlastnosti a hodnoty objektu a všech podřízených objektů.

@ObjectInfo.Print(person)

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

Vykreslí ověřovací test reCAPTCHA.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Nastaví veřejné a privátní klíče pro službu reCAPTCHA. Obvykle se tyto vlastnosti nastavují na stránce _AppStart .

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

`ReCaptcha.Validate([, privateKey])`

Vrátí výsledek testu reCAPTCHA.

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

`ServerInfo.GetHtml()`

Vykreslí informace o stavu ASP.NET webových stránek.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Vykreslí datový proud Twitteru pro zadaného uživatele.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Vykreslí stream Twitteru pro zadaný hledaný text.

@Twitter.Search("asp.net")

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

Vykreslí přehrávač videa Flash pro zadaný soubor s volitelnou šířkou a výškou.

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

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

Vykreslí windows media player pro zadaný soubor s volitelnou šířkou a výškou.

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

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

Vykreslí přehrávač Silverlight pro zadaný soubor .xap s požadovanou šířkou a výškou.

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

`WebCache.Get(key)`

Vrátí objekt určený klíčem nebo hodnotu null, pokud objekt nebyl nalezen.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Odebere objekt určený klíčem z mezipaměti.

WebCache.Remove("username")

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

Vloží hodnotu do mezipaměti pod názvem zadaným klíčem.

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

`WebGrid(data)`

Vytvoří nový WebGrid objekt pomocí dat z dotazu.

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

`WebGrid.GetHtml()`

Vykreslí značky pro zobrazení dat v tabulce HTML.

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

`WebGrid.Pager()`

Vykreslí pager objektu WebGrid .

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

`WebImage(path)`

Načte obrázek ze zadané cesty.

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

`WebImage.AddImagesWatermark(image)`

Přidá zadaný obrázek jako vodoznak.

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

`WebImage.AddTextWatermark(text)`

Přidá do obrázku zadaný text.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Překlopí obrázek vodorovně nebo svisle.

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

`WebImage.GetImageFromRequest()`

Načte obrázek při publikování obrázku na stránku během nahrávání souboru.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Změní velikost obrázku.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Otočí obrázek doleva nebo doprava.

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

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

Uloží obrázek do zadané cesty.

image.Save("test.png");

`WebMail.Password`

Nastaví heslo pro server SMTP. Za normálních okolností nastavíte tuto vlastnost na stránce _AppStart .

WebMail.Password = "password";

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

[, additionalHeaders])

Odešle e-mailovou zprávu.

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

`WebMail.SmtpServer`

Nastaví název serveru SMTP. Za normálních okolností nastavíte tuto vlastnost na stránce _AppStart .

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

`WebMail.UserName`

Nastaví uživatelské jméno serveru SMTP. Obvykle byste tuto vlastnost měli nastavit na stránce _AppStart .

WebMail.UserName = "Joe";

Ověřování

`Html.ValidationMessage(field)`

(v2) Vykreslí chybovou zprávu ověření pro zadané pole.

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

`Html.ValidationSummary([message])`

(v2) Zobrazí seznam všech chyb ověřování.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Zaregistruje vstupní prvek uživatele pro zadaný typ ověření.

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) Dynamicky vykreslí atributy třídy CSS pro ověření na straně klienta, abyste mohli formátovat chybové zprávy ověřování. (Vyžaduje odkazování na příslušné knihovny klientských skriptů a definování tříd 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) Povolí ověření vstupního pole uživatele na straně klienta. (Vyžaduje odkazování na příslušné knihovny klientských skriptů.)

<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) Vrátí hodnotu true, pokud všechny vstupní prvky uživatele, které jsou registrovány pro ověření, obsahují platné hodnoty.

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

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

(v2) Určuje, že uživatelé musí zadat hodnotu pro prvek vstupu uživatele.

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

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

(v2) Určuje, že uživatelé musí zadat hodnoty pro každý vstupní prvek uživatele. Tato metoda neumožňuje zadat vlastní chybovou zprávu.

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) Určuje ověřovací test při použití Validation.Add metody.

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."));

Sdílet prostřednictvím

ASP.NET Web Pages (Razor) API – stručná referenční příručka

Verze softwaru

Třídy

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)