Szybki przewodnik po interfejsie API ASP.NET Web Pages (Razor)

Artykuł
07/13/2023

Ta strona zawiera listę zawierającą krótkie przykłady najczęściej używanych obiektów, właściwości i metod programowania ASP.NET stron internetowych ze składnią Razor.

Opisy oznaczone ciągiem "(v2)" zostały wprowadzone w programie ASP.NET Web Pages w wersji 2.

Aby uzyskać dokumentację referencyjną interfejsu API, zobacz dokumentację referencyjną stron sieci Web ASP.NET w witrynie MSDN.

Wersje oprogramowania

ASP.NET Web Pages (Razor) 3

Ten samouczek działa również z programem ASP.NET Web Pages 2 i ASP.NET Web Pages 1.0 (z wyjątkiem funkcji oznaczonych jako wersja 2).

Ta strona zawiera informacje referencyjne dotyczące następujących elementów:

Klasy
Dane
Pomocników
Walidacja

Klasy

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

Zawiera dane, które mogą być udostępniane przez dowolne strony w aplikacji. Możesz użyć właściwości dynamicznej App , aby uzyskać dostęp do tych samych danych, co w poniższym przykładzie:

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

Konwertuje wartość ciągu na wartość logiczną (true/false). Zwraca wartość false lub określoną wartość, jeśli ciąg nie reprezentuje wartości true/false.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Konwertuje wartość ciągu na datę/godzinę. Zwraca DateTime.MinValue wartość lub określoną wartość, jeśli ciąg nie reprezentuje daty/godziny.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Konwertuje wartość ciągu na wartość dziesiętną. Zwraca wartość 0,0 lub określoną wartość, jeśli ciąg nie reprezentuje wartości dziesiętnej.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Konwertuje wartość ciągu na zmiennoprzecinkowy. Zwraca wartość 0,0 lub określoną wartość, jeśli ciąg nie reprezentuje wartości dziesiętnej.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Konwertuje wartość ciągu na liczbę całkowitą. Zwraca wartość 0 lub określoną wartość, jeśli ciąg nie reprezentuje liczby całkowitej.

int i = stringValue.AsInt();

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

Tworzy adres URL zgodny z przeglądarką na podstawie lokalnej ścieżki pliku z opcjonalnymi dodatkowymi częściami ścieżki.

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

`Html.Raw(value)`

Renderuje wartość jako znacznik HTML zamiast renderowania go jako dane wyjściowe zakodowane w formacie HTML.

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

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

Zwraca wartość true, jeśli wartość można przekonwertować z ciągu na określony typ.

var isint = stringValue.IsInt();

`IsEmpty()`

Zwraca wartość true, jeśli obiekt lub zmienna nie ma wartości.

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

`IsPost`

Zwraca wartość true, jeśli żądanie jest post. (Początkowe żądania są zwykle get).

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

`Layout`

Określa ścieżkę strony układu, która ma być stosowana do tej strony.

Layout = "_MyLayout.cshtml";

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

Zawiera dane współużytkowane przez stronę, strony układu i strony częściowe w bieżącym żądaniu. Możesz użyć właściwości dynamicznej Page , aby uzyskać dostęp do tych samych danych, co w poniższym przykładzie:

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

(Strony układu) Renderuje zawartość strony zawartości, która nie znajduje się w żadnych nazwanych sekcjach.

@RenderBody()

`RenderPage(path, values)`

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

Renderuje stronę zawartości przy użyciu określonej ścieżki i opcjonalnych dodatkowych danych. Możesz uzyskać wartości dodatkowych parametrów według PageData pozycji (przykład 1) lub klucza (przykład 2).

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

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

(Strony układu) Renderuje sekcję zawartości o nazwie. Ustaw wartość wymaganą na wartość false, aby ustawić sekcję opcjonalną.

@RenderSection("header")

`Request.Cookies[key]`

Pobiera lub ustawia wartość pliku cookie HTTP.

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

`Request.Files[key]`

Pobiera pliki przekazane w bieżącym żądaniu.

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

`Request.Form[key]`

Pobiera dane, które zostały opublikowane w formularzu (jako ciągi). Request[key] sprawdza zarówno kolekcje Request.Form , jak Request.QueryString i .

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

`Request.QueryString[key]`

Pobiera dane określone w ciągu zapytania adresu URL. Request[key] sprawdza zarówno kolekcje Request.Form , jak Request.QueryString i .

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]

Selektywnie wyłącza walidację żądania dla elementu formularza, wartości ciągu zapytania, pliku cookie lub wartości nagłówka. Walidacja żądań jest domyślnie włączona i uniemożliwia użytkownikom publikowanie znaczników lub innej potencjalnie niebezpiecznej zawartości.

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

Dodaje nagłówek serwera HTTP do odpowiedzi.

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

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

Buforuje dane wyjściowe strony przez określony czas. Opcjonalnie ustaw przesuwanie w celu zresetowania limitu czasu dla każdego dostępu do strony i zmienneByParams w celu buforowania różnych wersji strony dla każdego innego ciągu zapytania w żądaniu strony.

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

`Response.Redirect(path)`

Przekierowuje żądanie przeglądarki do nowej lokalizacji.

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

`Response.SetStatus(httpStatusCode)`

Ustawia kod stanu HTTP wysyłany do przeglądarki.

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

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

Zapisuje zawartość danych w odpowiedzi z opcjonalnym typem MIME.

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

`Response.WriteFile(file)`

Zapisuje zawartość pliku w odpowiedzi.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Strony układu) Definiuje sekcję zawartości, która ma nazwę.

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

`Server.HtmlDecode(htmlText)`

Dekoduje ciąg zakodowany w formacie HTML.

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

`Server.HtmlEncode(text)`

Koduje ciąg do renderowania w znaczników HTML.

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

`Server.MapPath(virtualPath)`

Zwraca ścieżkę fizyczną serwera dla określonej ścieżki wirtualnej.

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

`Server.UrlDecode(urlText)`

Dekoduje tekst z adresu URL.

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

`Server.UrlEncode(text)`

Koduje tekst do umieszczenia w adresie URL.

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

`Session[key]`

Pobiera lub ustawia wartość, która istnieje, dopóki użytkownik nie zamknie przeglądarki.

Session["FavoriteColor"] = "red";

`ToString()`

Wyświetla ciąg reprezentujący wartość obiektu.

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

`UrlData[index]`

Pobiera dodatkowe dane z adresu URL (na przykład /MyPage/ExtraData).

var pathInfo = UrlData[0];

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

Zmienia hasło określonego użytkownika.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Potwierdza konto przy użyciu tokenu potwierdzenia konta.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Tworzy nowe konto użytkownika z określoną nazwą użytkownika i hasłem. Aby wymagać tokenu potwierdzenia, przekaż wartość true dla parametru requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Pobiera identyfikator liczby całkowitej dla aktualnie zalogowanego użytkownika.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Pobiera nazwę aktualnie zalogowanego użytkownika.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Generuje token resetowania hasła, który można wysłać w wiadomości e-mail do użytkownika, aby użytkownik mógł zresetować hasło.

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

Zwraca identyfikator użytkownika z nazwy użytkownika.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Zwraca wartość true, jeśli bieżący użytkownik jest zalogowany.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Zwraca wartość true, jeśli użytkownik został potwierdzony (na przykład za pośrednictwem wiadomości e-mail z potwierdzeniem).

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

`WebSecurity.IsCurrentUser(userName)`

Zwraca wartość true, jeśli nazwa bieżącego użytkownika jest zgodna z określoną nazwą użytkownika.

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

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

Rejestruje użytkownika, ustawiając token uwierzytelniania w pliku cookie.

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

`WebSecurity.Logout()`

Rejestruje użytkownika, usuwając plik cookie tokenu uwierzytelniania.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Jeśli użytkownik nie jest uwierzytelniony, ustawia stan HTTP na 401 (Brak autoryzacji).

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Jeśli bieżący użytkownik nie jest członkiem jednej z określonych ról, ustawia stan HTTP na 401 (Brak autoryzacji).

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Jeśli bieżący użytkownik nie jest użytkownikiem określonym przez nazwę użytkownika, ustawia stan HTTP na 401 (Brak autoryzacji).

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Jeśli token resetowania hasła jest prawidłowy, zmienia hasło użytkownika na nowe hasło.

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

Dane

`Database.Execute(SQLstatement [,parameters]`

Wykonuje funkcję SQLstatement (z opcjonalnymi parametrami), takimi jak INSERT, DELETE lub UPDATE, i zwraca liczbę rekordów, których dotyczy problem.

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

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

`Database.GetLastInsertId()`

Zwraca kolumnę tożsamości z ostatnio wstawionego wiersza.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Otwiera określony plik bazy danych lub bazę danych określoną przy użyciu nazwanych parametrów połączenia z pliku 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)`

Otwiera bazę danych przy użyciu parametrów połączenia. (To kontrastuje z elementem Database.Open, który używa nazwy parametrów połączenia).

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

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

Wysyła zapytanie do bazy danych przy użyciu funkcji SQLstatement (opcjonalnie przekazując parametry) i zwraca wyniki jako kolekcję.

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

Wykonuje sqLstatement (z opcjonalnymi parametrami) i zwraca pojedynczy rekord.

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

Wykonuje sqLstatement (z opcjonalnymi parametrami) i zwraca pojedynczą wartość.

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

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

Pomocników

`Analytics.GetGoogleHtml(webPropertyId)`

Renderuje kod JavaScript usługi Google Analytics dla określonego identyfikatora.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Renderuje kod JavaScript StatCounter Analytics dla określonego projektu.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Renderuje kod JavaScript usługi Yahoo Analytics dla określonego konta.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Przekazuje wyszukiwanie do usługi Bing. Aby określić witrynę do wyszukiwania i tytuł pola wyszukiwania, możesz ustawić Bing.SiteUrl właściwości i Bing.SiteTitle . Zwykle te właściwości są ustawiane na stronie _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])`

Inicjuje wykres.

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

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

Dodaje legendę do wykresu.

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

Dodaje serię wartości do wykresu.

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

Zwraca wartość skrótu dla określonych danych. Domyślny algorytm to sha256.

@Crypto.Hash("data")

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

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

Umożliwia użytkownikom serwisu Facebook nawiązywanie połączenia ze stronami.

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

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

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

Renderuje interfejs użytkownika do przekazywania plików.

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

`GamerCard.GetHtml(gamerTag)`

Renderuje określony tag gamer xbox.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Renderuje obraz Gravatar dla określonego adresu e-mail.

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

`Json.Encode(object)`

Konwertuje obiekt danych na ciąg w formacie JavaScript Object Notation (JSON).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Konwertuje ciąg wejściowy zakodowany w formacie JSON na obiekt danych, który można iterować lub wstawiać do bazy danych.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Renderuje linki sieci społecznościowych przy użyciu określonego tytułu i opcjonalnego adresu URL.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Kojarzy komunikat o błędzie z polem formularza. ModelState Użyj pomocnika, aby uzyskać dostęp do tego członka.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Kojarzy komunikat o błędzie z formularzem. ModelState Użyj pomocnika, aby uzyskać dostęp do tego członka.

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

`ModelStateDictionary.IsValid`

Zwraca wartość true, jeśli nie ma błędów walidacji. ModelState Użyj pomocnika, aby uzyskać dostęp do tego członka.

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

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

Renderuje właściwości i wartości obiektu i wszystkich obiektów podrzędnych.

@ObjectInfo.Print(person)

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

Renderuje test weryfikacyjny RECAPTCHA.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Ustawia klucze publiczne i prywatne dla usługi reCAPTCHA. Zwykle te właściwości są ustawiane na stronie _AppStart .

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

`ReCaptcha.Validate([, privateKey])`

Zwraca wynik testu reCAPTCHA.

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

`ServerInfo.GetHtml()`

Renderuje informacje o stanie ASP.NET stron sieci Web.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Renderuje strumień usługi Twitter dla określonego użytkownika.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Renderuje strumień twitterowy dla określonego tekstu wyszukiwania.

@Twitter.Search("asp.net")

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

Renderuje odtwarzacz wideo Flash dla określonego pliku z opcjonalną szerokością i wysokością.

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

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

Renderuje odtwarzacz Windows Media Player dla określonego pliku z opcjonalną szerokością i wysokością.

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

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

Renderuje odtwarzacz Silverlight dla określonego pliku xap z wymaganą szerokością i wysokością.

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

`WebCache.Get(key)`

Zwraca obiekt określony przez klucz lub wartość null, jeśli obiekt nie zostanie znaleziony.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Usuwa obiekt określony przez klucz z pamięci podręcznej.

WebCache.Remove("username")

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

Umieszcza wartość w pamięci podręcznej pod nazwą określoną przez klucz.

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

`WebGrid(data)`

Tworzy nowy WebGrid obiekt przy użyciu danych z zapytania.

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

`WebGrid.GetHtml()`

Renderuje znaczniki do wyświetlania danych w tabeli HTML.

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

`WebGrid.Pager()`

Renderuje stronicator obiektu WebGrid .

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

`WebImage(path)`

Ładuje obraz z określonej ścieżki.

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

`WebImage.AddImagesWatermark(image)`

Dodaje określony obraz jako znak wodny.

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

`WebImage.AddTextWatermark(text)`

Dodaje określony tekst do obrazu.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Przerzuca obraz w poziomie lub w pionie.

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

`WebImage.GetImageFromRequest()`

Ładuje obraz po opublikowaniu obrazu na stronie podczas przekazywania pliku.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Zmienia rozmiar obrazu.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Obraca obraz w lewo lub po prawej stronie.

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

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

Zapisuje obraz w określonej ścieżce.

image.Save("test.png");

`WebMail.Password`

Ustawia hasło serwera SMTP. Zwykle ta właściwość jest ustawiana na stronie _AppStart .

WebMail.Password = "password";

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

[, additionalHeaders])

Wysyła wiadomość e-mail.

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

`WebMail.SmtpServer`

Ustawia nazwę serwera SMTP. Zwykle ta właściwość jest ustawiana na stronie _AppStart .

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

`WebMail.UserName`

Ustawia nazwę użytkownika dla serwera SMTP. Zwykle należy ustawić tę właściwość na stronie _AppStart .

WebMail.UserName = "Joe";

Walidacja

`Html.ValidationMessage(field)`

(wersja 2) Renderuje komunikat o błędzie weryfikacji dla określonego pola.

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

`Html.ValidationSummary([message])`

(wersja 2) Wyświetla listę wszystkich błędów walidacji.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(wersja 2) Rejestruje element wejściowy użytkownika dla określonego typu weryfikacji.

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

(wersja 2) Dynamicznie renderuje atrybuty klasy CSS na potrzeby weryfikacji po stronie klienta, dzięki czemu można formatować komunikaty o błędach walidacji. (Wymaga odwoływania się do odpowiednich bibliotek skryptów klienta i definiowanych klas 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)`

(wersja 2) Włącza walidację po stronie klienta dla pola danych wejściowych użytkownika. (Wymaga odwoływanie się do odpowiednich bibliotek client-script).

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

(wersja 2) Zwraca wartość true, jeśli wszystkie elementy wejściowe użytkownika, które są rejestrune na potrzeby walidacji, zawierają prawidłowe wartości.

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

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

(wersja 2) Określa, że użytkownicy muszą podać wartość elementu wejściowego użytkownika.

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

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

(wersja 2) Określa, że użytkownicy muszą podać wartości dla każdego z elementów wejściowych użytkownika. Ta metoda nie pozwala określić niestandardowego komunikatu o błędzie.

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

(wersja 2) Określa test weryfikacyjny podczas korzystania z Validation.Add metody .

Validation.Add("dateOfBirth", Validator.DateTime("Date of birth was not valid"));
Validation.Add("quantity", Validator.Integer("Enter a number"));
Validation.Add("confirmPassword", Validator.EqualsTo("password",
    "Passwords must match."));

Udostępnij za pośrednictwem

Szybki przewodnik po interfejsie API ASP.NET Web Pages (Razor)

Wersje oprogramowania

Klasy

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)