Kurzübersicht zur ASP.NET Web Pages-API (Razor)

Artikel
07/13/2023

Diese Seite enthält eine Liste mit kurzen Beispielen der am häufigsten verwendeten Objekte, Eigenschaften und Methoden zum Programmieren von ASP.NET Web Pages mit Razor-Syntax.

Beschreibungen, die mit "(v2)" gekennzeichnet sind, wurden in ASP.NET Web Pages Version 2 eingeführt.

Eine API-Referenzdokumentation finden Sie in der ASP.NET Web Pages-Referenzdokumentation auf MSDN.

Softwareversionen

ASP.NET Web Pages (Razor) 3

Dieses Tutorial funktioniert auch mit ASP.NET Web Pages 2 und ASP.NET Web Pages 1.0 (mit Ausnahme von Features, die mit v2 gekennzeichnet sind).

Diese Seite enthält Referenzinformationen für Folgendes:

Klassen
Daten
Hilfsmethoden
Überprüfung

Klassen

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

Enthält Daten, die von allen Seiten in der Anwendung freigegeben werden können. Sie können die dynamische App Eigenschaft verwenden, um auf dieselben Daten zuzugreifen, wie im folgenden Beispiel:

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

Konvertiert einen Zeichenfolgenwert in einen booleschen Wert (true/false). Gibt false oder den angegebenen Wert zurück, wenn die Zeichenfolge nicht true/false darstellt.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

Konvertiert einen Zeichenfolgenwert in Datum/Uhrzeit. Gibt oder den angegebenen Wert zurück DateTime.MinValue , wenn die Zeichenfolge kein Datum/eine Uhrzeit darstellt.

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Konvertiert einen Zeichenfolgenwert in einen Dezimalwert. Gibt 0,0 oder den angegebenen Wert zurück, wenn die Zeichenfolge keinen Dezimalwert darstellt.

decimal d = stringValue.AsDecimal();

`AsFloat(), AsFloat(value)`

Konvertiert einen Zeichenfolgenwert in einen float-Wert. Gibt 0,0 oder den angegebenen Wert zurück, wenn die Zeichenfolge keinen Dezimalwert darstellt.

float d = stringValue.AsFloat();

`AsInt(), AsInt(value)`

Konvertiert einen Zeichenfolgenwert in eine ganze Zahl. Gibt 0 oder den angegebenen Wert zurück, wenn die Zeichenfolge keine ganze Zahl darstellt.

int i = stringValue.AsInt();

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

Erstellt eine browserkompatible URL aus einem lokalen Dateipfad mit optionalen zusätzlichen Pfadteilen.

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

`Html.Raw(value)`

Rendert den Wert als HTML-Markup, anstatt ihn als HTML-codierte Ausgabe zu rendern.

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

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

Gibt true zurück, wenn der Wert von einer Zeichenfolge in den angegebenen Typ konvertiert werden kann.

var isint = stringValue.IsInt();

`IsEmpty()`

Gibt true zurück, wenn das Objekt oder die Variable keinen Wert hat.

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

`IsPost`

Gibt true zurück, wenn die Anforderung ein POST ist. (Anfängliche Anforderungen sind in der Regel ein GET.)

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

`Layout`

Gibt den Pfad einer Layoutseite an, die auf diese Seite angewendet werden soll.

Layout = "_MyLayout.cshtml";

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

Enthält Daten, die zwischen der Seite, Layoutseiten und Teilseiten in der aktuellen Anforderung gemeinsam genutzt werden. Sie können die dynamische Page Eigenschaft verwenden, um auf dieselben Daten zuzugreifen, wie im folgenden Beispiel:

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

(Layoutseiten) Rendert den Inhalt einer Inhaltsseite, die sich nicht in benannten Abschnitten befindet.

@RenderBody()

`RenderPage(path, values)`

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

Rendert eine Inhaltsseite unter Verwendung des angegebenen Pfads und optionaler zusätzlicher Daten. Sie können die Werte der zusätzlichen Parameter nach PageData Position (Beispiel 1) oder Schlüssel (Beispiel 2) abrufen.

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

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

(Layoutseiten) Rendert einen Inhaltsabschnitt mit einem Namen. Legen Sie erforderlich auf false fest, um einen Abschnitt optional zu machen.

@RenderSection("header")

`Request.Cookies[key]`

Ruft den Wert eines HTTP-Cookies ab oder legt den Wert fest.

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

`Request.Files[key]`

Ruft die Dateien ab, die in der aktuellen Anforderung hochgeladen wurden.

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

`Request.Form[key]`

Ruft Daten ab, die in einem Formular (als Zeichenfolgen) bereitgestellt wurden. Request[key] überprüft sowohl die Request.Form -Auflistung als auch die Request.QueryString -Auflistung.

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

`Request.QueryString[key]`

Ruft Daten ab, die in der URL-Abfragezeichenfolge angegeben wurden. Request[key] überprüft sowohl die Request.Form -Auflistung als auch die Request.QueryString -Auflistung.

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]

Deaktiviert selektiv die Anforderungsüberprüfung für ein Formularelement, einen Abfragezeichenfolgenwert, ein Cookie oder einen Headerwert. Die Anforderungsüberprüfung ist standardmäßig aktiviert und verhindert, dass Benutzer Markup oder andere potenziell gefährliche Inhalte veröffentlichen.

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

Fügt der Antwort einen HTTP-Serverheader hinzu.

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

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

Speichert die Seitenausgabe für eine angegebene Zeit zwischen. Legen Sie optional gleitend fest, um das Timeout für jeden Seitenzugriff zurückzusetzen, und varyByParams , um unterschiedliche Versionen der Seite für jede andere Abfragezeichenfolge in der Seitenanforderung zwischenzuspeichern.

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

`Response.Redirect(path)`

Leitet die Browseranforderung an einen neuen Speicherort um.

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

`Response.SetStatus(httpStatusCode)`

Legt den http-status code fest, der an den Browser gesendet wird.

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

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

Schreibt den Inhalt der Daten mit einem optionalen MIME-Typ in die Antwort.

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

`Response.WriteFile(file)`

Schreibt den Inhalt einer Datei in die Antwort.

Response.WriteFile("file.ext");

`@section(sectionName) {content }`

(Layoutseiten) Definiert einen Inhaltsabschnitt mit einem Namen.

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

`Server.HtmlDecode(htmlText)`

Decodiert eine Zeichenfolge, die HTML-codiert ist.

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

`Server.HtmlEncode(text)`

Codiert eine Zeichenfolge zum Rendern im HTML-Markup.

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

`Server.MapPath(virtualPath)`

Gibt den physischen Serverpfad für den angegebenen virtuellen Pfad zurück.

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

`Server.UrlDecode(urlText)`

Decodiert Text aus einer URL.

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

`Server.UrlEncode(text)`

Codiert Text, der in eine URL eingefügt werden soll.

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

`Session[key]`

Ruft einen Wert ab, der vorhanden ist, bis der Benutzer den Browser schließt, oder legt diesen fest.

Session["FavoriteColor"] = "red";

`ToString()`

Zeigt eine Zeichenfolgendarstellung des Objektwerts an.

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

`UrlData[index]`

Ruft zusätzliche Daten aus der URL ab (z. B. /MyPage/ExtraData).

var pathInfo = UrlData[0];

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

Ändert das Kennwort für den angegebenen Benutzer.

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

`WebSecurity.ConfirmAccount(accountConfirmationToken)`

Bestätigt ein Konto mithilfe des Kontobestätigungstokens.

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

`WebSecurity.CreateAccount(userName, password`

[, requireConfirmationToken = true|false])

Erstellt ein neues Benutzerkonto mit dem angegebenen Benutzernamen und Kennwort. Um ein Bestätigungstoken zu erfordern, übergeben Sie true für requireConfirmationToken.

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

`WebSecurity.CurrentUserId`

Ruft den ganzzahligen Bezeichner für den derzeit angemeldeten Benutzer ab.

var userId = WebSecurity.CurrentUserId;

`WebSecurity.CurrentUserName`

Ruft den Namen für den aktuell angemeldeten Benutzer ab.

var welcome = "Hello " + WebSecurity.CurrentUserName;

`WebSecurity.GeneratePasswordResetToken(username`

[, tokenExpirationInMinutesFromNow])

Generiert ein Kennwortzurücksetzungstoken, das per E-Mail an einen Benutzer gesendet werden kann, damit der Benutzer das Kennwort zurücksetzen kann.

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

Gibt die Benutzer-ID aus dem Benutzernamen zurück.

var userId = WebSecurity.GetUserId(userName);

`WebSecurity.IsAuthenticated`

Gibt true zurück, wenn der aktuelle Benutzer angemeldet ist.

if(WebSecurity.IsAuthenticated) {...}

`WebSecurity.IsConfirmed(userName)`

Gibt true zurück, wenn der Benutzer bestätigt wurde (z. B. durch eine Bestätigungs-E-Mail).

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

`WebSecurity.IsCurrentUser(userName)`

Gibt true zurück, wenn der Name des aktuellen Benutzers mit dem angegebenen Benutzernamen übereinstimmt.

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

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

Protokolliert den Benutzer in, indem ein Authentifizierungstoken im Cookie festgelegt wird.

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

`WebSecurity.Logout()`

Meldet den Benutzer ab, indem das Authentifizierungstoken-Cookie entfernt wird.

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Legt den HTTP-Status auf 401 (Nicht autorisiert) fest, wenn der Benutzer nicht authentifiziert ist.

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Wenn der aktuelle Benutzer kein Mitglied einer der angegebenen Rollen ist, legt den HTTP-status auf 401 (Nicht autorisiert) fest.

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Wenn der aktuelle Benutzer nicht der durch den Benutzernamen angegebene Benutzer ist, legt die HTTP-status auf 401 (Nicht autorisiert) fest.

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

Wenn das Kennwortzurücksetzungstoken gültig ist, ändert das Kennwort des Benutzers in das neue Kennwort.

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

Daten

`Database.Execute(SQLstatement [,parameters]`

Führt SQLstatement (mit optionalen Parametern) wie INSERT, DELETE oder UPDATE aus und gibt die Anzahl der betroffenen Datensätze zurück.

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

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

`Database.GetLastInsertId()`

Gibt die Identitätsspalte aus der zuletzt eingefügten Zeile zurück.

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

`Database.Open(filename)`

Database.Open(connectionStringName)

Öffnet entweder die angegebene Datenbankdatei oder die mithilfe einer benannten Verbindungszeichenfolge aus der Web.config-Datei angegebene Datenbank.

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

Öffnet eine Datenbank mithilfe der Verbindungszeichenfolge. (Dies steht im Gegensatz zu Database.Open, die einen Namen der Verbindungszeichenfolge verwendet.)

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

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

Fragt die Datenbank mithilfe von SQLstatement ab (optional Übergeben von Parametern) und gibt die Ergebnisse als Sammlung zurück.

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

Führt SQLstatement (mit optionalen Parametern) aus und gibt einen einzelnen Datensatz zurück.

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

Führt SQLstatement (mit optionalen Parametern) aus und gibt einen einzelnen Wert zurück.

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

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

Hilfsmethoden

`Analytics.GetGoogleHtml(webPropertyId)`

Rendert den Google Analytics-JavaScript-Code für die angegebene ID.

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Rendert den StatCounter Analytics-JavaScript-Code für das angegebene Projekt.

@Analytics.GetStatCounterHtml(89, "security")

`Analytics.GetYahooHtml(account)`

Rendert den Yahoo Analytics JavaScript-Code für das angegebene Konto.

@Analytics.GetYahooHtml("myaccount")

`Bing.SearchBox([boxWidth])`

Übergibt eine Suche an Bing. Um die zu durchsuchende Website und einen Titel für das Suchfeld anzugeben, können Sie die Bing.SiteUrl Eigenschaften und Bing.SiteTitle festlegen. Normalerweise legen Sie diese Eigenschaften auf der Seite _AppStart fest.

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

Initialisiert ein Diagramm.

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

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

Fügt einem Diagramm eine Legende hinzu.

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

Fügt dem Diagramm eine Reihe von Werten hinzu.

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

Gibt einen Hash für die angegebenen Daten zurück. Der Standardalgorithmus ist sha256.

@Crypto.Hash("data")

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

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

Ermöglicht Facebook-Benutzern, eine Verbindung mit Seiten herzustellen.

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

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

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

Rendert die Benutzeroberfläche zum Hochladen von Dateien.

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

`GamerCard.GetHtml(gamerTag)`

Rendert das angegebene Xbox-Gamer-Tag.

@GamerCard.GetHtml("joe")

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

[, imageExtension] [, attributes])

Rendert das Gravatar-Bild für die angegebene E-Mail-Adresse.

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

`Json.Encode(object)`

Konvertiert ein Datenobjekt in eine Zeichenfolge im JSON-Format (JavaScript Object Notation).

var myJsonString = Json.Encode(dataObject);

`Json.Decode(string)`

Konvertiert eine JSON-codierte Eingabezeichenfolge in ein Datenobjekt, das Sie durchlaufen oder in eine Datenbank einfügen können.

var myJsonObj = Json.Decode(jsonString);

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

[, additionalTweetText] [, linkSites])

Rendert Links für soziale Netzwerke unter Verwendung des angegebenen Titels und der optionalen URL.

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

`ModelStateDictionary.AddError(key, errorMessage)`

Ordnet eine Fehlermeldung einem Formularfeld zu. Verwenden Sie das ModelState Hilfsprogramm, um auf dieses Element zuzugreifen.

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

`ModelStateDictionary.AddFormError(errorMessage)`

Ordnet eine Fehlermeldung einem Formular zu. Verwenden Sie das ModelState Hilfsprogramm, um auf dieses Element zuzugreifen.

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

`ModelStateDictionary.IsValid`

Gibt true zurück, wenn keine Validierungsfehler vorliegen. Verwenden Sie das ModelState Hilfsprogramm, um auf dieses Element zuzugreifen.

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

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

Rendert die Eigenschaften und Werte eines Objekts und aller untergeordneten Objekte.

@ObjectInfo.Print(person)

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

Rendert den reCAPTCHA-Überprüfungstest.

@ReCaptcha.GetHtml()

`ReCaptcha.PublicKey`

ReCaptcha.PrivateKey

Legt öffentliche und private Schlüssel für den reCAPTCHA-Dienst fest. Normalerweise legen Sie diese Eigenschaften auf der Seite _AppStart fest.

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

`ReCaptcha.Validate([, privateKey])`

Gibt das Ergebnis des reCAPTCHA-Tests zurück.

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

`ServerInfo.GetHtml()`

Rendert status Informationen zu ASP.NET Web Pages.

@ServerInfo.GetHtml()

`Twitter.Profile(twitterUserName)`

Rendert einen Twitter-Stream für den angegebenen Benutzer.

@Twitter.Profile("billgates")

`Twitter.Search(searchQuery)`

Rendert einen Twitter-Stream für den angegebenen Suchtext.

@Twitter.Search("asp.net")

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

Rendert einen Flash-Videoplayer für die angegebene Datei mit optionaler Breite und Höhe.

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

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

Rendert einen Windows Media-Player für die angegebene Datei mit optionaler Breite und Höhe.

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

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

Rendert einen Silverlight-Player für die angegebene XAP-Datei mit der erforderlichen Breite und Höhe.

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

`WebCache.Get(key)`

Gibt das durch den Schlüssel angegebene Objekt oder NULL zurück, wenn das Objekt nicht gefunden wird.

var username = WebCache.Get("username")

`WebCache.Remove(key)`

Entfernt das durch schlüssel angegebene Objekt aus dem Cache.

WebCache.Remove("username")

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

Fügt den Wert unter dem durch schlüssel angegebenen Namen in den Cache ein.

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

`WebGrid(data)`

Erstellt ein neues WebGrid Objekt mithilfe von Daten aus einer Abfrage.

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

`WebGrid.GetHtml()`

Rendert Markup, um Daten in einer HTML-Tabelle anzuzeigen.

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

`WebGrid.Pager()`

Rendert einen Pager für das WebGrid -Objekt.

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

`WebImage(path)`

Lädt ein Image aus dem angegebenen Pfad.

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

`WebImage.AddImagesWatermark(image)`

Fügt das angegebene Bild als Wasserzeichen hinzu.

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

`WebImage.AddTextWatermark(text)`

Fügt dem Bild den angegebenen Text hinzu.

image.AddTextWatermark("Copyright")

`WebImage.FlipHorizontal()`

WebImage.FlipVertical()

Kippt das Bild horizontal oder vertikal.

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

`WebImage.GetImageFromRequest()`

Lädt ein Bild, wenn ein Bild während eines Dateiuploads auf eine Seite gepostet wird.

var image = WebImage.GetImageFromRequest();

`WebImage.Resize(width,height)`

Ändert die Größe eines Bilds.

image.Resize(100, 100);

`WebImage.RotateLeft()`

WebImage.RotateRight()

Dreht das Bild nach links oder rechts.

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

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

Speichert das Image im angegebenen Pfad.

image.Save("test.png");

`WebMail.Password`

Legt das Kennwort für den SMTP-Server fest. Normalerweise legen Sie diese Eigenschaft auf der seite _AppStart fest.

WebMail.Password = "password";

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

[, additionalHeaders])

Sendet eine E-Mail.

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

`WebMail.SmtpServer`

Legt den NAMEN des SMTP-Servers fest. Normalerweise legen Sie diese Eigenschaft auf der seite _AppStart fest.

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

`WebMail.UserName`

Legt den Benutzernamen für den SMTP-Server fest. Normalerweise sollten Sie diese Eigenschaft auf der Seite _AppStart festlegen.

WebMail.UserName = "Joe";

Überprüfen

`Html.ValidationMessage(field)`

(v2) Rendert eine Überprüfungsfehlermeldung für das angegebene Feld.

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

`Html.ValidationSummary([message])`

(v2) Zeigt eine Liste aller Validierungsfehler an.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Registriert ein Benutzereingabeelement für den angegebenen Validierungstyp.

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) Rendert dynamisch CSS-Klassenattribute für die clientseitige Überprüfung, sodass Sie Validierungsfehlermeldungen formatieren können. (Erfordert, dass Sie auf die entsprechenden Clientskriptbibliotheken verweisen und CSS-Klassen definieren.)

<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) Aktiviert die clientseitige Validierung für das Benutzereingabefeld. (Erfordert, dass Sie auf die entsprechenden Clientskriptbibliotheken verweisen.)

<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) Gibt true zurück, wenn alle Benutzereingabeelemente, die für die Validierung registriert sind, gültige Werte enthalten.

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

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

(v2) Gibt an, dass Benutzer einen Wert für das Benutzereingabeelement angeben müssen.

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

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

(v2) Gibt an, dass Benutzer Werte für jedes Benutzereingabeelement bereitstellen müssen. Mit dieser Methode können Sie keine benutzerdefinierte Fehlermeldung angeben.

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) Gibt einen Validierungstest an, wenn Sie die Validation.Add -Methode verwenden.

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

Freigeben über

Kurzübersicht zur ASP.NET Web Pages-API (Razor)

Softwareversionen

Klassen

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)