Referência rápida da API do Páginas da Web do ASP.NET (Razor)

Artigo
07/13/2023

Esta página contém uma lista com breves exemplos dos objetos, propriedades e métodos mais usados para programação Páginas da Web do ASP.NET com sintaxe Razor.

Descrições marcadas com "(v2)" foram introduzidas no Páginas da Web do ASP.NET versão 2.

Para obter a documentação de referência da API, consulte a Documentação de referência do Páginas da Web do ASP.NET no MSDN.

Versões de software

Páginas da Web do ASP.NET (Razor) 3

Este tutorial também funciona com Páginas da Web do ASP.NET 2 e Páginas da Web do ASP.NET 1.0 (exceto para recursos marcados como v2).

Esta página contém informações de referência para o seguinte:

Classes
Dados
Auxiliares
Validação

Classes

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

Contém dados que podem ser compartilhados por qualquer página no aplicativo. Você pode usar a propriedade dinâmica App para acessar os mesmos dados, como no exemplo a seguir:

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 um valor de cadeia de caracteres em um valor booliano (true/false). Retornará false ou o valor especificado se a cadeia de caracteres não representar true/false.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Converte um valor de cadeia de caracteres em data/hora. Retorna DateTime.MinValue ou o valor especificado se a cadeia de caracteres não representa uma data/hora.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Converte um valor de cadeia de caracteres em um valor decimal. Retornará 0,0 ou o valor especificado se a cadeia de caracteres não representar um valor decimal.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Converte um valor de cadeia de caracteres em um float. Retornará 0,0 ou o valor especificado se a cadeia de caracteres não representar um valor decimal.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Converte um valor de cadeia de caracteres em um inteiro. Retorna 0 ou o valor especificado se a cadeia de caracteres não representa um inteiro.

int i = stringValue.AsInt();

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

Cria uma URL compatível com navegador de um caminho de arquivo local, com partes de caminho adicionais opcionais.

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

`Html.Raw(value)`

Renderiza o valor como marcação HTML em vez de renderizá-lo como saída codificada em HTML.

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

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

Retornará true se o valor puder ser convertido de uma cadeia de caracteres para o tipo especificado.

var isint = stringValue.IsInt();

`IsEmpty()`

Retornará true se o objeto ou a variável não tiver nenhum valor.

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

`IsPost`

Retornará true se a solicitação for post. (As solicitações iniciais geralmente são get.)

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

`Layout`

Especifica o caminho de uma página de layout a ser aplicada a esta página.

Layout = "_MyLayout.cshtml";

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

Contém dados compartilhados entre a página, as páginas de layout e as páginas parciais na solicitação atual. Você pode usar a propriedade dinâmica Page para acessar os mesmos dados, como no exemplo a seguir:

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 layout) Renderiza o conteúdo de uma página de conteúdo que não está em nenhuma seção nomeada.

@RenderBody()

`RenderPage(path, values)`

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

Renderiza uma página de conteúdo usando o caminho especificado e dados extras opcionais. Você pode obter os valores dos parâmetros extras de PageData por posição (exemplo 1) ou chave (exemplo 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 layout) Renderiza uma seção de conteúdo que tem um nome. Defina necessário como false para tornar uma seção opcional.

@RenderSection("header")

`Request.Cookies[key]`

Obtém ou define o valor de um cookie HTTP.

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

`Request.Files[key]`

Obtém os arquivos que foram carregados na solicitação atual.

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

`Request.Form[key]`

Obtém dados que foram postados em um formulário (como cadeias de caracteres). Request[key] verifica as Request.Form coleções e Request.QueryString .

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

`Request.QueryString[key]`

Obtém dados que foram especificados na cadeia de caracteres de consulta de URL. Request[key] verifica as Request.Form coleções e 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]

Desabilita seletivamente a validação de solicitação para um elemento de formulário, valor de cadeia de caracteres de consulta, cookie ou valor de cabeçalho. A validação de solicitação é habilitada por padrão e impede que os usuários postem marcação ou outro conteúdo potencialmente perigoso.

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

Adiciona um cabeçalho de servidor HTTP à resposta.

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

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

Armazena em cache a saída da página por um horário especificado. Opcionalmente, defina deslizante para redefinir o tempo limite em cada acesso de página e varyByParams para armazenar em cache versões diferentes da página para cada cadeia de caracteres de consulta diferente na solicitação de página.

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

`Response.Redirect(path)`

Redireciona a solicitação do navegador para um novo local.

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

`Response.SetStatus(httpStatusCode)`

Define o código de status HTTP enviado ao navegador.

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

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

Grava o conteúdo dos dados na resposta com um tipo MIME opcional.

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

`Response.WriteFile(file)`

Grava o conteúdo de um arquivo na resposta.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Páginas de layout) Define uma seção de conteúdo que tem um nome.

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

`Server.HtmlDecode(htmlText)`

Decodifica uma cadeia de caracteres codificada em HTML.

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

`Server.HtmlEncode(text)`

Codifica uma cadeia de caracteres para renderização na marcação HTML.

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

`Server.MapPath(virtualPath)`

Retorna o caminho físico do servidor para o caminho virtual especificado.

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

`Server.UrlDecode(urlText)`

Decodifica o texto de uma URL.

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

`Server.UrlEncode(text)`

Codifica o texto a ser colocado em uma URL.

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

`Session[key]`

Obtém ou define um valor que existe até que o usuário feche o navegador.

Session["FavoriteColor"] = "red";

`ToString()`

Exibe uma representação de cadeia de caracteres do valor do objeto.

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

`UrlData[index]`

Obtém dados adicionais da URL (por exemplo, /MyPage/ExtraData).

var pathInfo = UrlData[0];

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

Altera a senha para o usuário especificado.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Confirma uma conta usando o token de confirmação da conta.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Cria uma nova conta de usuário com o nome de usuário e a senha especificados. Para exigir um token de confirmação, passe true para requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Obtém o identificador inteiro para o usuário conectado no momento.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Obtém o nome do usuário conectado no momento.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Gera um token de redefinição de senha que pode ser enviado por email a um usuário para que o usuário possa redefinir a senha.

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

Retorna a ID de usuário do nome de usuário.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Retornará true se o usuário atual estiver conectado.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Retornará true se o usuário tiver sido confirmado (por exemplo, por meio de um email de confirmação).

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

`WebSecurity.IsCurrentUser(userName)`

Retornará true se o nome do usuário atual corresponder ao nome de usuário especificado.

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

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

Faz logon do usuário definindo um token de autenticação no cookie.

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

`WebSecurity.Logout()`

Faz logoff do usuário removendo o cookie de token de autenticação.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Se o usuário não estiver autenticado, define o status HTTP como 401 (Não autorizado).

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Se o usuário atual não for membro de uma das funções especificadas, definirá o status HTTP como 401 (Não autorizado).

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Se o usuário atual não for o usuário especificado pelo nome de usuário, definirá o status HTTP como 401 (Não autorizado).

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Se o token de redefinição de senha for válido, alterará a senha do usuário para a nova senha.

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

Dados

`Database.Execute(SQLstatement [,parameters]`

Executa SQLstatement (com parâmetros opcionais), como INSERT, DELETE ou UPDATE, e retorna uma contagem de registros afetados.

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

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

`Database.GetLastInsertId()`

Retorna a coluna de identidade da linha inserida mais recentemente.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Abre o arquivo de banco de dados especificado ou o banco de dados especificado usando uma cadeia de conexão nomeada do arquivo 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 um banco de dados usando a cadeia de conexão. (Isso contrasta com Database.Open, que usa um nome de cadeia de conexão.)

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

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

Consulta o banco de dados usando SQLstatement (opcionalmente passando parâmetros) e retorna os resultados como uma coleção.

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

Executa SQLstatement (com parâmetros opcionais) e retorna um ú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])`

Executa SQLstatement (com parâmetros opcionais) e retorna um único valor.

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

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

Auxiliares

`Analytics.GetGoogleHtml(webPropertyId)`

Renderiza o código JavaScript do Google Analytics para a ID especificada.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Renderiza o código JavaScript do StatCounter Analytics para o projeto especificado.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Renderiza o código JavaScript do Yahoo Analytics para a conta especificada.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Passa uma pesquisa para o Bing. Para especificar o site a ser pesquisado e um título para a caixa de pesquisa, você pode definir as Bing.SiteUrl propriedades e Bing.SiteTitle . Normalmente, você define essas propriedades na 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 um gráfico.

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

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

Adiciona uma legenda a um 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])

Adiciona uma série de valores ao 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])

Retorna um hash para os dados especificados. O algoritmo padrão é sha256.

@Crypto.Hash("data")

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

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

Permite que os usuários do Facebook façam uma conexão com páginas.

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

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

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

Renderiza a interface do usuário para carregar arquivos.

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

`GamerCard.GetHtml(gamerTag)`

Renderiza a marca de gamer do Xbox especificada.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Renderiza a imagem gravatar para o endereço de email especificado.

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

`Json.Encode(object)`

Converte um objeto de dados em uma cadeia de caracteres no formato JSON (JavaScript Object Notation).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Converte uma cadeia de caracteres de entrada codificada em JSON em um objeto de dados que você pode iterar ou inserir em um banco de dados.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Renderiza links de rede social usando o título especificado e a URL opcional.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Associa uma mensagem de erro a um campo de formulário. Use o ModelState auxiliar para acessar esse membro.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Associa uma mensagem de erro a um formulário. Use o ModelState auxiliar para acessar esse membro.

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

`ModelStateDictionary.IsValid`

Retornará true se não houver erros de validação. Use o ModelState auxiliar para acessar esse membro.

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

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

Renderiza as propriedades e os valores de um objeto e de qualquer objeto filho.

@ObjectInfo.Print(person)

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

Renderiza o teste de verificação reCAPTCHA.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Define chaves públicas e privadas para o serviço reCAPTCHA. Normalmente, você define essas propriedades na página _AppStart .

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

`ReCaptcha.Validate([, privateKey])`

Retorna o resultado do teste reCAPTCHA.

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

`ServerInfo.GetHtml()`

Renderiza status informações sobre Páginas da Web do ASP.NET.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Renderiza um fluxo do Twitter para o usuário especificado.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Renderiza um fluxo do Twitter para o texto de pesquisa especificado.

@Twitter.Search("asp.net")

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

Renderiza um player de vídeo Flash para o arquivo especificado com largura e altura opcionais.

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

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

Renderiza um player do Windows Media para o arquivo especificado com largura e altura opcionais.

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

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

Renderiza um player do Silverlight para o arquivo .xap especificado com largura e altura necessárias.

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

`WebCache.Get(key)`

Retorna o objeto especificado por chave ou nulo se o objeto não for encontrado.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Remove o objeto especificado por chave do cache.

WebCache.Remove("username")

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

Coloca o valor no cache sob o nome especificado pela chave.

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

`WebGrid(data)`

Cria um novo WebGrid objeto usando dados de uma consulta.

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

`WebGrid.GetHtml()`

Renderiza a marcação para exibir dados em uma tabela HTML.

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

`WebGrid.Pager()`

Renderiza um pager para o WebGrid objeto .

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

`WebImage(path)`

Carrega uma imagem do caminho especificado.

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

`WebImage.AddImagesWatermark(image)`

Adiciona a imagem especificada como uma marca d'água.

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

`WebImage.AddTextWatermark(text)`

Adiciona o texto especificado à imagem.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Inverte a imagem horizontal ou verticalmente.

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

`WebImage.GetImageFromRequest()`

Carrega uma imagem quando uma imagem é postada em uma página durante um upload de arquivo.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Redimensiona uma imagem.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Gira a imagem para a esquerda ou para a direita.

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

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

Salva a imagem no caminho especificado.

image.Save("test.png");

`WebMail.Password`

Define a senha do servidor SMTP. Normalmente, você define essa propriedade na página _AppStart .

WebMail.Password = "password";

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

[, additionalHeaders])

Envia uma mensagem de email.

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

`WebMail.SmtpServer`

Define o nome do servidor SMTP. Normalmente, você define essa propriedade na página _AppStart .

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

`WebMail.UserName`

Define o nome de usuário para o servidor SMTP. Normalmente, você deve definir essa propriedade na página _AppStart .

WebMail.UserName = "Joe";

Validação

`Html.ValidationMessage(field)`

(v2) Renderiza uma mensagem de erro de validação para o campo especificado.

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

`Html.ValidationSummary([message])`

(v2) Exibe uma lista de todos os erros de validação.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Registra um elemento de entrada do usuário para o tipo de validação 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) Renderiza dinamicamente atributos de classe CSS para validação do lado do cliente para que você possa formatar mensagens de erro de validação. (Requer que você faça referência às bibliotecas de script de cliente apropriadas e que defina 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) Habilita a validação do lado do cliente para o campo de entrada do usuário. (Requer que você faça referência às bibliotecas de script de cliente apropriadas.)

<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) Retornará true se todos os elementos de entrada do usuário que são registros para validação contiverem valores válidos.

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

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

(v2) Especifica que os usuários devem fornecer um valor para o elemento de entrada do usuário.

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

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

(v2) Especifica que os usuários devem fornecer valores para cada um dos elementos de entrada do usuário. Esse método não permite que você especifique uma mensagem de erro personalizada.

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 um teste de validação quando você usa o Validation.Add método .

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

Compartilhar via

Referência rápida da API do Páginas da Web do ASP.NET (Razor)

Versões de software

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)