Referencia rápida de API de ASP.NET Web Pages (Razor)

Artículo
07/13/2023

Esta página contiene una lista con breves ejemplos de los objetos, propiedades y métodos más usados para programar ASP.NET Páginas web con sintaxis de Razor.

Las descripciones marcadas con "(v2)" se introdujeron en ASP.NET Web Pages versión 2.

Para obtener documentación de referencia de API, vea la documentación de referencia de ASP.NET Web Pages en MSDN.

Versiones de software

ASP.NET Web Pages (Razor) 3

Este tutorial también funciona con ASP.NET Web Pages 2 y ASP.NET Web Pages 1.0 (excepto las características marcadas como v2).

Esta página contiene información de referencia para lo siguiente:

Clases
Data
Asistentes
Validación

Clases

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

Contiene datos que pueden compartirse en cualquier página de la aplicación. Puede usar la propiedad App dinámica para acceder a los mismos datos, como en el ejemplo siguiente:

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

Convierte un valor de cadena en un valor booleano (true/false). Devuelve false o el valor especificado si la cadena no representa true/false.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Convierte un valor de cadena en fecha y hora. Devuelve DateTime.MinValue o el valor especificado si la cadena no representa una fecha y hora.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Convierte un valor de cadena en un valor decimal. Devuelve 0,0 o el valor especificado si la cadena no representa un valor decimal.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Convierte un valor de cadena en un valor float. Devuelve 0,0 o el valor especificado si la cadena no representa un valor decimal.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Convierte un valor de cadena en un entero. Devuelve 0 o el valor especificado si la cadena no representa un entero.

int i = stringValue.AsInt();

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

Crea una dirección URL compatible con el explorador a partir de una ruta de acceso del archivo local, con partes de ruta de acceso adicionales opcionales.

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

`Html.Raw(value)`

Representa valor como marcado HTML en lugar de representarlo como salida codificada en HTML.

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

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

Devuelve true si el valor se puede convertir de una cadena al tipo especificado.

var isint = stringValue.IsInt();

`IsEmpty()`

Devuelve true si el objeto o variable no tiene ningún valor.

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

`IsPost`

Devuelve true si la solicitud es POST. (Las solicitudes iniciales suelen ser GET.)

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

`Layout`

Especifica la ruta de acceso de una página de diseño que se va a aplicar a esta página.

Layout = "_MyLayout.cshtml";

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

Contiene datos compartidos entre la página, las páginas de diseño y las páginas parciales de la solicitud actual. Puede usar la propiedad Page dinámica para acceder a los mismos datos, como en el ejemplo siguiente:

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

(Páginas de diseño) Representa el contenido de una página de contenido que no está en ninguna sección con nombre.

@RenderBody()

`RenderPage(path, values)`

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

Representa una página de contenido mediante la ruta de acceso especificada y datos adicionales opcionales. Puede obtener los valores de los parámetros adicionales de PageData por posición (ejemplo 1) o clave (ejemplo 2).

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

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

(Páginas de diseño) Representa una sección de contenido que tiene un nombre. Establezca obligatorio en false para que una sección sea opcional.

@RenderSection("header")

`Request.Cookies[key]`

Obtiene o establece el valor de una cookie HTTP.

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

`Request.Files[key]`

Obtiene los archivos que se cargaron en la solicitud actual.

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

`Request.Form[key]`

Obtiene los datos que se publicaron en un formulario (como cadenas). Request[key] comprueba tanto el Request.Form como las colecciones de Request.QueryString.

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

`Request.QueryString[key]`

Obtiene los datos especificados en la cadena de consulta URL. Request[key] comprueba tanto el Request.Form como las colecciones de 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]

Deshabilita selectivamente la validación de solicitudes para un elemento de formulario, un valor de cadena de consulta, una cookie o un valor de encabezado. La validación de solicitudes está habilitada de forma predeterminada e impide que los usuarios publiquen marcados u otro contenido potencialmente peligroso.

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

Agrega un encabezado de servidor HTTP a la respuesta.

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

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

Almacena en caché la salida de la página durante un tiempo especificado. Opcionalmente, establezca deslizante para restablecer el tiempo de espera en cada acceso de página y varyByParams para almacenar en caché diferentes versiones de la página para cada cadena de consulta diferente en la solicitud de página.

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

`Response.Redirect(path)`

Redirige la solicitud del explorador a una nueva ubicación.

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

`Response.SetStatus(httpStatusCode)`

Establece el código de estado HTTP enviado al explorador.

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

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

Escribe el contenido de datos en la respuesta con un tipo MIME opcional.

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

`Response.WriteFile(file)`

Escribe el contenido de un archivo en la respuesta.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Páginas de diseño) Define una sección de contenido que tiene un nombre.

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

`Server.HtmlDecode(htmlText)`

Descodifica una cadena codificada en HTML.

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

`Server.HtmlEncode(text)`

Codifica una cadena para la representación en marcado HTML.

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

`Server.MapPath(virtualPath)`

Devuelve la ruta de acceso física del servidor para la ruta de acceso virtual especificada.

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

`Server.UrlDecode(urlText)`

Descodifica el texto de una dirección URL.

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

`Server.UrlEncode(text)`

Codifica el texto que se va a colocar en una dirección URL.

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

`Session[key]`

Obtiene o establece un valor que existe hasta que el usuario cierra el explorador.

Session["FavoriteColor"] = "red";

`ToString()`

Muestra una representación de cadena del valor del objeto.

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

`UrlData[index]`

Obtiene datos adicionales de la dirección URL (por ejemplo, /MyPage/ExtraData).

var pathInfo = UrlData[0];

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

Cambia la contraseña del usuario especificado.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Confirma una cuenta con el token de confirmación de la cuenta.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Crea una nueva cuenta de usuario con el nombre de usuario y la contraseña especificados. Para requerir un token de confirmación, pase true para requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Obtiene el identificador entero del usuario que ha iniciado sesión actualmente.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Obtiene el nombre del usuario que ha iniciado sesión actualmente.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Genera un token de restablecimiento de contraseña que se puede enviar por correo electrónico a un usuario para que el usuario pueda restablecer la contraseña.

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

Devuelve el identificador de usuario del nombre de usuario.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Devuelve true si el usuario actual ha iniciado sesión.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Devuelve true si el usuario se ha confirmado (por ejemplo, a través de un correo electrónico de confirmación).

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

`WebSecurity.IsCurrentUser(userName)`

Devuelve true si el nombre del usuario actual coincide con el nombre de usuario especificado.

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

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

Registra al usuario en estableciendo un token de autenticación en la cookie.

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

`WebSecurity.Logout()`

Cierra la sesión del usuario quitando la cookie del token de autenticación.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Si el usuario no está autenticado, establece el estado HTTP en 401 (no autorizado).

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Si el usuario actual no es miembro de uno de los roles especificados, establece el estado HTTP en 401 (no autorizado).

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Si el usuario actual no es el usuario especificado por nombre de usuario, establece el estado HTTP en 401 (no autorizado).

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Si el token de restablecimiento de contraseña es válido, cambia la contraseña del usuario a la nueva contraseña.

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

Data

`Database.Execute(SQLstatement [,parameters]`

Ejecuta SQLstatement (con parámetros opcionales), como INSERT, DELETE o UPDATE y devuelve un recuento de registros afectados.

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

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

`Database.GetLastInsertId()`

Devuelve la columna de identidad de la fila insertada más recientemente.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Abre el archivo de base de datos especificado o la base de datos especificada mediante una cadena de conexión con nombre del archivo 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)`

Abre una base de datos mediante la cadena de conexión. (Esto contrasta con Database.Open, que usa un nombre de cadena de conexión.)

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

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

Consulta la base de datos mediante SQLstatement (opcionalmente, pasando parámetros) y devuelve los resultados como una colección.

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

Ejecuta SQLstatement (con parámetros opcionales) y devuelve un único registro.

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

Ejecuta SQLstatement (con parámetros opcionales) y devuelve un valor único.

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

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

Asistentes

`Analytics.GetGoogleHtml(webPropertyId)`

Representa el código JavaScript de Google Analytics para el identificador especificado.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Representa el código JavaScript de StatCounter Analytics para el proyecto especificado.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Representa el código JavaScript de Yahoo Analytics para la cuenta especificada.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Pasa una búsqueda a Bing. Para especificar el sitio que se va a buscar y un título para el cuadro de búsqueda, puede establecer las propiedades Bing.SiteUrl y Bing.SiteTitle. Normalmente, estas propiedades se establecen en la página _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])`

Inicializa un gráfico.

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

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

Agrega una leyenda a un gráfico.

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

Agrega una serie de valores al gráfico.

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

Devuelve un hash para los datos especificados. El algoritmo predeterminado es sha256.

@Crypto.Hash("data")

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

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

Permite a los usuarios de Facebook realizar una conexión a páginas.

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

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

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

Representa la interfaz de usuario para cargar archivos.

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

`GamerCard.GetHtml(gamerTag)`

Representa la etiqueta de juego de Xbox especificada.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Representa la imagen Gravatar para la dirección de correo electrónico especificada.

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

`Json.Encode(object)`

Convierte un objeto de datos en una cadena en el formato de notación de objetos JavaScript (JSON).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Convierte una cadena de entrada codificada en JSON en un objeto de datos que puede iterar o insertar en una base de datos.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Representa vínculos de redes sociales mediante el título especificado y la dirección URL opcional.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Asocia un mensaje de error a un campo de formulario. Use el asistente de ModelState para acceder a este miembro.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Asocia un mensaje de error a un formulario. Use el asistente de ModelState para acceder a este miembro.

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

`ModelStateDictionary.IsValid`

Devuelve true si no hay errores de validación. Use el asistente de ModelState para acceder a este miembro.

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

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

Representa las propiedades y los valores de un objeto y de cualquier objeto secundario.

@ObjectInfo.Print(person)

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

Representa la prueba de comprobación de reCAPTCHA.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Establece claves públicas y privadas para el servicio reCAPTCHA. Normalmente, estas propiedades se establecen en la página _AppStart.

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

`ReCaptcha.Validate([, privateKey])`

Devuelve el resultado de la prueba reCAPTCHA.

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

`ServerInfo.GetHtml()`

Representa información de estado sobre ASP.NET Web Pages.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Representa una secuencia de Twitter para el usuario especificado.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Representa una secuencia de Twitter para el texto de búsqueda especificado.

@Twitter.Search("asp.net")

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

Representa un reproductor de vídeo Flash para el archivo especificado con ancho y alto opcionales.

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

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

Representa un reproductor de Windows Media para el archivo especificado con ancho y alto opcionales.

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

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

Representa un reproductor de Silverlight para el archivo .xap especificado con ancho y alto necesarios.

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

`WebCache.Get(key)`

Devuelve el objeto especificado por clave, o null si no se encuentra el objeto.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Quita el objeto especificado por clave de la memoria caché.

WebCache.Remove("username")

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

Coloca el valor en la memoria caché bajo el nombre especificado por clave.

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

`WebGrid(data)`

Crea un nuevo objeto WebGrid mediante datos de una consulta.

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

`WebGrid.GetHtml()`

Representa el marcado para mostrar datos en una tabla HTML.

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

`WebGrid.Pager()`

Representa un buscapersonas para el objeto WebGrid.

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

`WebImage(path)`

Carga una imagen de la ruta de acceso especificada.

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

`WebImage.AddImagesWatermark(image)`

Agrega la imagen especificada como marca de agua.

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

`WebImage.AddTextWatermark(text)`

Agrega el texto especificado a la imagen.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Voltea la imagen horizontal o verticalmente.

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

`WebImage.GetImageFromRequest()`

Carga una imagen cuando se publica una imagen en una página durante una carga de archivos.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Cambia el tamaño de una imagen.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Gira la imagen a la izquierda o a la derecha.

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

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

Guarda la imagen en la ruta de acceso especificada.

image.Save("test.png");

`WebMail.Password`

Establece la contraseña del servidor SMTP. Normalmente, esta propiedad se establece en la página de _AppStart.

WebMail.Password = "password";

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

[, additionalHeaders])

Envía un mensaje de correo electrónico.

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

`WebMail.SmtpServer`

Establece el nombre del servidor SMTP. Normalmente, esta propiedad se establece en la página de _AppStart.

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

`WebMail.UserName`

Establece el nombre de usuario para el servidor SMTP. Normalmente, debe establecer esta propiedad en la página _AppStart.

WebMail.UserName = "Joe";

Validation

`Html.ValidationMessage(field)`

(v2) Representa un mensaje de error de validación para el campo especificado.

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

`Html.ValidationSummary([message])`

(v2) Muestra una lista de todos los errores de validación.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Registra un elemento de entrada de usuario para el tipo de validación especificado.

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) Representa dinámicamente los atributos de clase CSS para la validación del lado cliente para que pueda dar formato a los mensajes de error de validación. (Requiere que haga referencia a las bibliotecas de script de cliente adecuadas y que defina las clases 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) Habilita la validación del lado cliente para el campo de entrada del usuario. (Requiere que haga referencia a las bibliotecas de script de cliente adecuadas.)

<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) Devuelve true si todos los elementos de entrada de usuario registrados para la validación contienen valores válidos.

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

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

(v2) Especifica que los usuarios deben proporcionar un valor para el elemento de entrada de usuario.

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

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

(v2) Especifica que los usuarios deben proporcionar valores para cada uno de los elementos de entrada del usuario. Este método no permite especificar un mensaje de error personalizado.

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) Especifica una prueba de validación cuando se usa el método 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."));

Compartir a través de

Referencia rápida de API de ASP.NET Web Pages (Razor)

Versiones de software

Clases

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)