Informations de référence rapides sur l’API pages Web ASP.NET (Razor)

Article
07/13/2023

Cette page contient une liste contenant de brefs exemples des objets, propriétés et méthodes les plus couramment utilisés pour la programmation d’pages Web ASP.NET avec la syntaxe Razor.

Les descriptions marquées par « (v2) » ont été introduites dans pages Web ASP.NET version 2.

Pour obtenir de la documentation de référence sur l’API, consultez la documentation de référence pages Web ASP.NET sur MSDN.

Versions des logiciels

pages Web ASP.NET (Razor) 3

Ce tutoriel fonctionne également avec pages Web ASP.NET 2 et pages Web ASP.NET 1.0 (à l’exception des fonctionnalités marquées v2).

Cette page contient des informations de référence pour les éléments suivants :

Classes
Données
Programmes d’assistance
Validation

Classes

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

Contient des données qui peuvent être partagées par n’importe quelle page de l’application. Vous pouvez utiliser la propriété dynamique App pour accéder aux mêmes données, comme dans l’exemple suivant :

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

Convertit une valeur de chaîne en valeur booléenne (true/false). Retourne false ou la valeur spécifiée si la chaîne ne représente pas true/false.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Convertit une valeur de chaîne en date/heure. Renvoie DateTime.MinValue ou la valeur spécifiée si la chaîne ne représente pas de date/heure.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Convertit une valeur de chaîne en valeur décimale. Retourne 0,0 ou la valeur spécifiée si la chaîne ne représente pas de valeur décimale.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Convertit une valeur de chaîne en float. Retourne 0,0 ou la valeur spécifiée si la chaîne ne représente pas de valeur décimale.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Convertit une valeur de chaîne en entier. Retourne 0 ou la valeur spécifiée si la chaîne ne représente pas d’entier.

int i = stringValue.AsInt();

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

Crée une URL compatible avec le navigateur à partir d’un chemin d’accès local, avec des parties de chemin d’accès supplémentaires facultatives.

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

`Html.Raw(value)`

Rend la valeur sous forme de balisage HTML au lieu de la rendre sous forme de sortie encodée html.

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

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

Retourne true si la valeur peut être convertie d’une chaîne au type spécifié.

var isint = stringValue.IsInt();

`IsEmpty()`

Retourne true si l’objet ou la variable n’a aucune valeur.

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

`IsPost`

Retourne la valeur true si la requête est une requête POST. (Les demandes initiales sont généralement un GET.)

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

`Layout`

Spécifie le chemin d’accès d’une page de mise en page à appliquer à cette page.

Layout = "_MyLayout.cshtml";

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

Contient des données partagées entre la page, les pages de mise en page et les pages partielles de la demande actuelle. Vous pouvez utiliser la propriété dynamique Page pour accéder aux mêmes données, comme dans l’exemple suivant :

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

(Pages de disposition) Affiche le contenu d’une page de contenu qui ne figure dans aucune section nommée.

@RenderBody()

`RenderPage(path, values)`

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

Restitue une page de contenu à l’aide du chemin d’accès spécifié et des données supplémentaires facultatives. Vous pouvez obtenir les valeurs des paramètres supplémentaires à partir de la position (exemple 1) ou de PageData la clé (exemple 2).

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

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

(Pages de disposition) Affiche une section de contenu qui a un nom. Définissez obligatoire sur false pour rendre une section facultative.

@RenderSection("header")

`Request.Cookies[key]`

Obtient ou définit la valeur d’un cookie HTTP.

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

`Request.Files[key]`

Obtient les fichiers qui ont été chargés dans la demande actuelle.

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

`Request.Form[key]`

Obtient les données qui ont été publiées dans un formulaire (sous forme de chaînes). Request[key]vérifie à la fois les Request.Form collections et .Request.QueryString

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

`Request.QueryString[key]`

Obtient les données qui ont été spécifiées dans la chaîne de requête d’URL. Request[key]vérifie à la fois les Request.Form collections et .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]

Désactive de manière sélective la validation des demandes pour un élément de formulaire, une valeur de chaîne de requête, un cookie ou une valeur d’en-tête. La validation des demandes est activée par défaut et empêche les utilisateurs de publier du balisage ou d’autres contenus potentiellement dangereux.

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

Ajoute un en-tête de serveur HTTP à la réponse.

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

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

Met en cache la sortie de la page pendant une durée spécifiée. Définissez éventuellement le glissement pour réinitialiser le délai d’expiration de chaque accès à la page et varierByParams pour mettre en cache différentes versions de la page pour chaque chaîne de requête différente dans la demande de page.

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

`Response.Redirect(path)`

Redirige la demande de navigateur vers un nouvel emplacement.

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

`Response.SetStatus(httpStatusCode)`

Définit le code HTTP status envoyé au navigateur.

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

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

Écrit le contenu des données dans la réponse avec un type MIME facultatif.

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

`Response.WriteFile(file)`

Écrit le contenu d’un fichier dans la réponse.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Pages de disposition) Définit une section de contenu qui a un nom.

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

`Server.HtmlDecode(htmlText)`

Décode une chaîne encodée au format HTML.

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

`Server.HtmlEncode(text)`

Encode une chaîne pour le rendu dans le balisage HTML.

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

`Server.MapPath(virtualPath)`

Retourne le chemin d’accès physique du serveur pour le chemin d’accès virtuel spécifié.

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

`Server.UrlDecode(urlText)`

Décode le texte d’une URL.

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

`Server.UrlEncode(text)`

Encode le texte à placer dans une URL.

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

`Session[key]`

Obtient ou définit une valeur qui existe jusqu’à ce que l’utilisateur ferme le navigateur.

Session["FavoriteColor"] = "red";

`ToString()`

Affiche une représentation sous forme de chaîne de la valeur de l’objet.

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

`UrlData[index]`

Obtient des données supplémentaires à partir de l’URL (par exemple, /MyPage/ExtraData).

var pathInfo = UrlData[0];

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

Définit le mot de passe de l'utilisateur spécifié.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Confirme un compte à l’aide du jeton de confirmation du compte.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Crée un compte d’utilisateur avec le nom d’utilisateur et le mot de passe spécifiés. Pour exiger un jeton de confirmation, passez true pour requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Obtient l’identificateur entier de l’utilisateur actuellement connecté.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Obtient le nom de l’utilisateur actuellement connecté.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Génère un jeton de réinitialisation de mot de passe qui peut être envoyé par e-mail à un utilisateur afin que l’utilisateur puisse réinitialiser le mot de passe.

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

Retourne l’ID d’utilisateur à partir du nom d’utilisateur.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Retourne la valeur true si l’utilisateur actuel est connecté.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Retourne true si l’utilisateur a été confirmé (par exemple, via un e-mail de confirmation).

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

`WebSecurity.IsCurrentUser(userName)`

Retourne true si le nom de l’utilisateur actuel correspond au nom d’utilisateur spécifié.

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

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

Enregistre l’utilisateur en définissant un jeton d’authentification dans le cookie.

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

`WebSecurity.Logout()`

Déconnecte l’utilisateur en supprimant le cookie de jeton d’authentification.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Si l'utilisateur n'est pas authentifié, définit l'état HTTP sur 401 (non autorisé).

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Si l’utilisateur actuel n’est pas membre de l’un des rôles spécifiés, définit le status HTTP sur 401 (Non autorisé).

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Si l’utilisateur actuel n’est pas l’utilisateur spécifié par le nom d’utilisateur, définit le status HTTP sur 401 (Non autorisé).

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Si le jeton de réinitialisation de mot de passe est valide, remplacez le mot de passe de l’utilisateur par le nouveau mot de passe.

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

Données

`Database.Execute(SQLstatement [,parameters]`

Exécute SQLstatement (avec des paramètres facultatifs) tels que INSERT, DELETE ou UPDATE et retourne un nombre d’enregistrements affectés.

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

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

`Database.GetLastInsertId()`

Retourne la colonne d’identité de la ligne la plus récemment insérée.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Ouvre le fichier de base de données spécifié ou la base de données spécifiée à l’aide d’une chaîne de connexion nommée du fichier 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)`

Ouvre une base de données à l’aide de la chaîne de connexion. (Cela contraste avec Database.Open, qui utilise un nom de chaîne de connexion.)

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

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

Interroge la base de données à l’aide de SQLstatement (éventuellement en passant des paramètres) et retourne les résultats sous forme de collection.

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

Exécute SQLstatement (avec des paramètres facultatifs) et retourne un enregistrement unique.

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

Exécute SQLstatement (avec des paramètres facultatifs) et retourne une valeur unique.

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

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

Programmes d’assistance

`Analytics.GetGoogleHtml(webPropertyId)`

Restitue le code JavaScript De Google Analytics pour l’ID spécifié.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Restitue le code JavaScript StatCounter Analytics pour le projet spécifié.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Restitue le code JavaScript Yahoo Analytics pour le compte spécifié.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Transmet une recherche à Bing. Pour spécifier le site à rechercher et un titre pour la zone de recherche, vous pouvez définir les Bing.SiteUrl propriétés et Bing.SiteTitle . Normalement, vous définissez ces propriétés dans la page _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])`

Initialise un graphique.

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

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

Ajoute une légende à un graphique.

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

Ajoute une série de valeurs au graphique.

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

Retourne un hachage pour les données spécifiées. L’algorithme par défaut est sha256.

@Crypto.Hash("data")

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

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

Permet aux utilisateurs de Facebook de se connecter à des pages.

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

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

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

Restitue l’interface utilisateur pour le chargement de fichiers.

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

`GamerCard.GetHtml(gamerTag)`

Restitue la balise de joueur Xbox spécifiée.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Restitue l’image Gravatar pour l’adresse e-mail spécifiée.

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

`Json.Encode(object)`

Convertit un objet de données en chaîne au format JSON (JavaScript Object Notation).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Convertit une chaîne d’entrée encodée au format JSON en objet de données que vous pouvez itérer sur ou insérer dans une base de données.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Restitue les liens de réseau social à l’aide du titre et de l’URL facultative spécifiés.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Associe un message d’erreur à un champ de formulaire. Utilisez l’assistance ModelState pour accéder à ce membre.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Associe un message d’erreur à un formulaire. Utilisez l’assistance ModelState pour accéder à ce membre.

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

`ModelStateDictionary.IsValid`

Retourne true s’il n’y a pas d’erreurs de validation. Utilisez l’assistance ModelState pour accéder à ce membre.

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

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

Restitue les propriétés et les valeurs d’un objet et de tous les objets enfants.

@ObjectInfo.Print(person)

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

Affiche le test de vérification reCAPTCHA.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Définit des clés publiques et privées pour le service reCAPTCHA. Normalement, vous définissez ces propriétés dans la page _AppStart .

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

`ReCaptcha.Validate([, privateKey])`

Retourne le résultat du test reCAPTCHA.

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

`ServerInfo.GetHtml()`

Affiche status informations sur pages Web ASP.NET.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Restitue un flux Twitter pour l’utilisateur spécifié.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Affiche un flux Twitter pour le texte de recherche spécifié.

@Twitter.Search("asp.net")

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

Affiche un lecteur vidéo Flash pour le fichier spécifié avec une largeur et une hauteur facultatives.

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

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

Affiche un lecteur Windows Media pour le fichier spécifié avec une largeur et une hauteur facultatives.

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

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

Affiche un lecteur Silverlight pour le fichier .xap spécifié avec la largeur et la hauteur requises.

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

`WebCache.Get(key)`

Renvoie l’objet spécifié par clé ou null si l’objet est introuvable.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Supprime de la cache l’objet spécifié par la clé .

WebCache.Remove("username")

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

Place la valeur dans le cache sous le nom spécifié par la clé.

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

`WebGrid(data)`

Crée un WebGrid objet à l’aide des données d’une requête.

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

`WebGrid.GetHtml()`

Restitue le balisage pour afficher les données dans une table HTML.

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

`WebGrid.Pager()`

Affiche un pagineur pour l’objet WebGrid .

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

`WebImage(path)`

Charge une image à partir du chemin spécifié.

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

`WebImage.AddImagesWatermark(image)`

Ajoute l’image spécifiée en filigrane.

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

`WebImage.AddTextWatermark(text)`

Ajoute le texte spécifié à l’image.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Retourne l’image horizontalement ou verticalement.

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

`WebImage.GetImageFromRequest()`

Charge une image lorsqu’une image est publiée sur une page pendant le chargement d’un fichier.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Redimensionne une image.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Fait pivoter l’image vers la gauche ou la droite.

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

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

Enregistre l’image dans le chemin spécifié.

image.Save("test.png");

`WebMail.Password`

Définit le mot de passe du serveur SMTP. Normalement, vous définissez cette propriété dans la page _AppStart .

WebMail.Password = "password";

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

[, additionalHeaders])

Envoie un e-mail.

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

`WebMail.SmtpServer`

Définit le nom du serveur SMTP. Normalement, vous définissez cette propriété dans la page _AppStart .

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

`WebMail.UserName`

Définit le nom d’utilisateur du serveur SMTP. Normalement, vous devez définir cette propriété dans la page _AppStart .

WebMail.UserName = "Joe";

Validation

`Html.ValidationMessage(field)`

(v2) Affiche un message d’erreur de validation pour le champ spécifié.

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

`Html.ValidationSummary([message])`

(v2) Affiche la liste de toutes les erreurs de validation.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Inscrit un élément d’entrée utilisateur pour le type de validation spécifié.

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) Affiche dynamiquement les attributs de classe CSS pour la validation côté client afin que vous puissiez mettre en forme les messages d’erreur de validation. (Vous devez référencer les bibliothèques de script client appropriées et définir des classes 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) Active la validation côté client pour le champ d’entrée utilisateur. (Vous devez référencer les bibliothèques de script client appropriées.)

<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) Retourne true si tous les éléments d’entrée utilisateur enregistrés pour la validation contiennent des valeurs valides.

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

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

(v2) Spécifie que les utilisateurs doivent fournir une valeur pour l’élément d’entrée utilisateur.

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

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

(v2) Spécifie que les utilisateurs doivent fournir des valeurs pour chacun des éléments d’entrée utilisateur. Cette méthode ne vous permet pas de spécifier un message d’erreur personnalisé.

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) Spécifie un test de validation lorsque vous utilisez la Validation.Add méthode .

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

Partager via

Informations de référence rapides sur l’API pages Web ASP.NET (Razor)

Versions des logiciels

Classes

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)