Informazioni di riferimento rapido sulle API Pagine Web ASP.NET (Razor)

Articolo
07/13/2023

Questa pagina contiene un elenco con brevi esempi di oggetti, proprietà e metodi usati più di frequente per la programmazione Pagine Web ASP.NET con la sintassi Razor.

Le descrizioni contrassegnate con "(v2)" sono state introdotte in Pagine Web ASP.NET versione 2.

Per la documentazione di riferimento sulle API, vedere la documentazione di riferimento Pagine Web ASP.NET su MSDN.

Versioni software

Pagine Web ASP.NET (Razor) 3

Questa esercitazione funziona anche con Pagine Web ASP.NET 2 e Pagine Web ASP.NET 1.0 (ad eccezione delle funzionalità contrassegnate con v2).

Questa pagina contiene informazioni di riferimento per quanto segue:

Classi
Dati
Helper
Convalida

Classi

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

Contiene dati che possono essere condivisi da qualsiasi pagina dell'applicazione. È possibile usare la proprietà dinamica App per accedere agli stessi dati, come nell'esempio seguente:

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

Converte un valore stringa in un valore booleano (true/false). Restituisce false o il valore specificato se la stringa non rappresenta true/false.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Converte un valore stringa in data/ora. Restituisce DateTime.MinValue o il valore specificato se la stringa non rappresenta una data/ora.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Converte un valore stringa in un valore decimale. Restituisce 0,0 o il valore specificato se la stringa non rappresenta un valore decimale.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Converte un valore stringa in un valore float. Restituisce 0,0 o il valore specificato se la stringa non rappresenta un valore decimale.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Converte un valore stringa in un numero intero. Restituisce 0 o il valore specificato se la stringa non rappresenta un numero intero.

int i = stringValue.AsInt();

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

Crea un URL compatibile con il browser da un percorso di file locale, con parti di percorso aggiuntive facoltative.

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

`Html.Raw(value)`

Esegue il rendering del valore come markup HTML invece di eseguirne il rendering come output con codifica HTML.

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

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

Restituisce true se il valore può essere convertito da una stringa al tipo specificato.

var isint = stringValue.IsInt();

`IsEmpty()`

Restituisce true se l'oggetto o la variabile non ha alcun valore.

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

`IsPost`

Restituisce true se la richiesta è post. Le richieste iniziali sono in genere GET.

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

`Layout`

Specifica il percorso di una pagina di layout da applicare a questa pagina.

Layout = "_MyLayout.cshtml";

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

Contiene dati condivisi tra la pagina, le pagine di layout e le pagine parziali nella richiesta corrente. È possibile usare la proprietà dinamica Page per accedere agli stessi dati, come nell'esempio seguente:

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

(Pagine di layout) Esegue il rendering del contenuto di una pagina di contenuto non presente in alcuna sezione denominata.

@RenderBody()

`RenderPage(path, values)`

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

Esegue il rendering di una pagina di contenuto usando il percorso specificato e i dati aggiuntivi facoltativi. È possibile ottenere i valori dei parametri aggiuntivi da PageData per posizione (esempio 1) o chiave (esempio 2).

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

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

(Pagine di layout) Esegue il rendering di una sezione di contenuto con un nome. Impostare obbligatorio su false per rendere facoltativa una sezione.

@RenderSection("header")

`Request.Cookies[key]`

Ottiene o imposta il valore di un cookie HTTP.

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

`Request.Files[key]`

Ottiene i file caricati nella richiesta corrente.

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

`Request.Form[key]`

Ottiene i dati inseriti in un modulo (come stringhe). Request[key] controlla sia le Request.Form raccolte che le Request.QueryString raccolte.

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

`Request.QueryString[key]`

Ottiene i dati specificati nella stringa di query URL. Request[key] controlla sia le Request.Form raccolte che le Request.QueryString raccolte.

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]

Disabilita in modo selettivo la convalida delle richieste per un elemento del modulo, un valore della stringa di query, un cookie o un valore di intestazione. La convalida delle richieste è abilitata per impostazione predefinita e impedisce agli utenti di pubblicare markup o altri contenuti potenzialmente pericolosi.

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

Aggiunge un'intestazione del server HTTP alla risposta.

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

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

Memorizza nella cache l'output della pagina per un'ora specificata. Impostare facoltativamente scorrimento per reimpostare il timeout in ogni accesso alla pagina e variareByParams per memorizzare nella cache versioni diverse della pagina per ogni stringa di query diversa nella richiesta di pagina.

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

`Response.Redirect(path)`

Reindirizza la richiesta del browser a una nuova posizione.

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

`Response.SetStatus(httpStatusCode)`

Imposta il codice di stato HTTP inviato al browser.

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

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

Scrive il contenuto dei dati nella risposta con un tipo MIME facoltativo.

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

`Response.WriteFile(file)`

Scrive il contenuto di un file nella risposta.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Pagine di layout) Definisce una sezione del contenuto con un nome.

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

`Server.HtmlDecode(htmlText)`

Decodifica una stringa codificata in FORMATO HTML.

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

`Server.HtmlEncode(text)`

Codifica una stringa per il rendering nel markup HTML.

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

`Server.MapPath(virtualPath)`

Restituisce il percorso fisico del server per il percorso virtuale specificato.

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

`Server.UrlDecode(urlText)`

Decodifica il testo da un URL.

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

`Server.UrlEncode(text)`

Codifica il testo da inserire in un URL.

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

`Session[key]`

Ottiene o imposta un valore esistente finché l'utente non chiude il browser.

Session["FavoriteColor"] = "red";

`ToString()`

Visualizza una rappresentazione di stringa del valore dell'oggetto.

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

`UrlData[index]`

Ottiene dati aggiuntivi dall'URL, ad esempio /MyPage/ExtraData.

var pathInfo = UrlData[0];

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

Modifica la password per l'utente specificato.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Conferma un account usando il token di conferma dell'account.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Crea un nuovo account utente con il nome utente e la password specificati. Per richiedere un token di conferma, passare true per requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Ottiene l'identificatore integer per l'utente attualmente connesso.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Ottiene il nome dell'utente attualmente connesso.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Genera un token di reimpostazione della password che può essere inviato tramite posta elettronica a un utente in modo che l'utente possa reimpostare la password.

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

Restituisce l'ID utente dal nome utente.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Restituisce true se l'utente corrente è connesso.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Restituisce true se l'utente è stato confermato, ad esempio tramite un messaggio di posta elettronica di conferma.

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

`WebSecurity.IsCurrentUser(userName)`

Restituisce true se il nome dell'utente corrente corrisponde al nome utente specificato.

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

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

Registra l'utente in impostando un token di autenticazione nel cookie.

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

`WebSecurity.Logout()`

Disconnette l'utente rimuovendo il cookie del token di autenticazione.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Se l'utente non è autenticato, imposta lo stato HTTP su 401 (Non autorizzato).

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Se l'utente corrente non è membro di uno dei ruoli specificati, imposta lo stato HTTP su 401 (Non autorizzato).

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Se l'utente corrente non è l'utente specificato dal nome utente, imposta lo stato HTTP su 401 (Non autorizzato).

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Se il token di reimpostazione della password è valido, modificare la password dell'utente con la nuova password.

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

Dati

`Database.Execute(SQLstatement [,parameters]`

Esegue SQLstatement (con parametri facoltativi), ad esempio INSERT, DELETE o UPDATE e restituisce un conteggio dei record interessati.

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

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

`Database.GetLastInsertId()`

Restituisce la colonna di identità dalla riga inserita più di recente.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Apre il file di database specificato o il database specificato utilizzando una stringa di connessione denominata dal file diWeb.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)`

Apre un database usando la stringa di connessione. In contrasto con Database.Open, che usa un nome di stringa di connessione.

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

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

Esegue una query sul database usando SQLstatement (facoltativamente passando parametri) e restituisce i risultati come raccolta.

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

Esegue SQLstatement (con parametri facoltativi) e restituisce un singolo record.

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

Esegue SQLstatement (con parametri facoltativi) e restituisce un singolo valore.

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

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

Helper

`Analytics.GetGoogleHtml(webPropertyId)`

Esegue il rendering del codice JavaScript di Google Analytics per l'ID specificato.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Esegue il rendering del codice JavaScript di StatCounter Analytics per il progetto specificato.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Esegue il rendering del codice JavaScript di Yahoo Analytics per l'account specificato.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Passa una ricerca a Bing. Per specificare il sito in cui cercare e un titolo per la casella di ricerca, è possibile impostare le Bing.SiteUrl proprietà e Bing.SiteTitle . In genere si impostano queste proprietà nella pagina _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])`

Inizializza un grafico.

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

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

Aggiunge una legenda a un grafico.

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

Aggiunge una serie di valori al grafico.

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

Restituisce un hash per i dati specificati. L'algoritmo predefinito è sha256.

@Crypto.Hash("data")

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

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

Consente agli utenti di Facebook di creare una connessione alle pagine.

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

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

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

Esegue il rendering dell'interfaccia utente per il caricamento di file.

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

`GamerCard.GetHtml(gamerTag)`

Esegue il rendering del tag xbox gamer specificato.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Esegue il rendering dell'immagine Gravatar per l'indirizzo di posta elettronica specificato.

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

`Json.Encode(object)`

Converte un oggetto dati in una stringa nel formato JavaScript Object Notation (JSON).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Converte una stringa di input con codifica JSON in un oggetto dati che è possibile eseguire l'iterazione o inserire in un database.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Esegue il rendering dei collegamenti di social networking usando il titolo e l'URL facoltativo specificati.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Associa un messaggio di errore a un campo modulo. Usare l'helper ModelState per accedere a questo membro.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Associa un messaggio di errore a un modulo. Usare l'helper ModelState per accedere a questo membro.

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

`ModelStateDictionary.IsValid`

Restituisce true se non sono presenti errori di convalida. Usare l'helper ModelState per accedere a questo membro.

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

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

Esegue il rendering delle proprietà e dei valori di un oggetto e di qualsiasi oggetto figlio.

@ObjectInfo.Print(person)

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

Esegue il rendering del test di verifica reCAPTCHA.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Imposta chiavi pubbliche e private per il servizio reCAPTCHA. In genere si impostano queste proprietà nella pagina _AppStart .

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

`ReCaptcha.Validate([, privateKey])`

Restituisce il risultato del test reCAPTCHA.

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

`ServerInfo.GetHtml()`

Esegue il rendering delle informazioni sullo stato relative alle Pagine Web ASP.NET.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Esegue il rendering di un flusso Twitter per l'utente specificato.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Esegue il rendering di un flusso Twitter per il testo di ricerca specificato.

@Twitter.Search("asp.net")

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

Esegue il rendering di un lettore video Flash per il file specificato con larghezza e altezza facoltative.

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

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

Esegue il rendering di un lettore Windows Media per il file specificato con larghezza e altezza facoltativa.

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

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

Esegue il rendering di un lettore Silverlight per il file con estensione xap specificato con larghezza e altezza necessarie.

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

`WebCache.Get(key)`

Restituisce l'oggetto specificato dalla chiave o null se l'oggetto non viene trovato.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Rimuove l'oggetto specificato dalla chiave dalla cache.

WebCache.Remove("username")

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

Inserisce il valore nella cache sotto il nome specificato dalla chiave.

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

`WebGrid(data)`

Crea un nuovo WebGrid oggetto usando dati da una query.

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

`WebGrid.GetHtml()`

Esegue il rendering del markup per visualizzare i dati in una tabella HTML.

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

`WebGrid.Pager()`

Esegue il rendering di un pager per l'oggetto WebGrid .

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

`WebImage(path)`

Carica un'immagine dal percorso specificato.

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

`WebImage.AddImagesWatermark(image)`

Aggiunge l'immagine specificata come filigrana.

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

`WebImage.AddTextWatermark(text)`

Aggiunge il testo specificato all'immagine.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Capovolge l'immagine orizzontalmente o verticalmente.

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

`WebImage.GetImageFromRequest()`

Carica un'immagine quando un'immagine viene pubblicata in una pagina durante il caricamento di un file.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Ridimensiona un'immagine.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Ruota l'immagine a sinistra o a destra.

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

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

Salva l'immagine nel percorso specificato.

image.Save("test.png");

`WebMail.Password`

Imposta la password per il server SMTP. In genere, questa proprietà viene impostata nella pagina _AppStart .

WebMail.Password = "password";

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

[, additionalHeaders])

Invia un messaggio di posta elettronica.

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

`WebMail.SmtpServer`

Imposta il nome del server SMTP. In genere, questa proprietà viene impostata nella pagina _AppStart .

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

`WebMail.UserName`

Imposta il nome utente per il server SMTP. In genere, è consigliabile impostare questa proprietà nella pagina _AppStart .

WebMail.UserName = "Joe";

Convalida

`Html.ValidationMessage(field)`

(v2) Esegue il rendering di un messaggio di errore di convalida per il campo specificato.

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

`Html.ValidationSummary([message])`

(v2) Visualizza un elenco di tutti gli errori di convalida.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Registra un elemento di input utente per il tipo specificato di convalida.

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) Esegue il rendering dinamico degli attributi della classe CSS per la convalida lato client in modo che sia possibile formattare i messaggi di errore di convalida. Richiede di fare riferimento alle librerie di script client appropriate e che si definiscono classi 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) Abilita la convalida lato client per il campo di input dell'utente. Richiede di fare riferimento alle librerie client-script appropriate.

<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) Restituisce true se tutti gli elementi di input utente registrati per la convalida contengono valori validi.

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

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

(v2) Specifica che gli utenti devono fornire un valore per l'elemento di input utente.

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

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

(v2) Specifica che gli utenti devono fornire valori per ognuno degli elementi di input dell'utente. Questo metodo non consente di specificare un messaggio di errore personalizzato.

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) Specifica un test di convalida quando si usa il Validation.Add metodo .

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

Condividi tramite

Informazioni di riferimento rapido sulle API Pagine Web ASP.NET (Razor)

Versioni software

Classi

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)