Schnellreferenz zur API für ASP.NET-Webseiten („Razor“)

von Tom FitzMacken

Diese Seite enthält eine Liste mit kurzen Beispielen der am häufigsten verwendeten Objekte, Eigenschaften und Methoden für die Programmierung ASP.NET Webseiten mit Razor-Syntax.

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

Api-Referenzdokumentation finden Sie in der Referenzdokumentation zu ASP.NET Webseiten auf MSDN.

Softwareversionen

ASP.NET Webseiten (Razor) 3

Dieses Lernprogramm funktioniert auch mit ASP.NET Webseiten 2 und ASP.NET Webseiten 1.0 (mit Ausnahme der mit v2 markierten Features).

Diese Seite enthält Referenzinformationen für Folgendes:

Klassen
Daten
Hilfsprogramme
Ü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 wahr/falsch darstellt.

bool b = stringValue.AsBool();

`AsDateTime(), AsDateTime(value)`

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

DateTime dt = stringValue.AsDateTime();

`AsDecimal(), AsDecimal(value)`

Wandelt einen Zeichenfolgenwert in einen Dezimalwert um. 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 aufweist.

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

`IsPost`

Gibt true zurück, wenn es sich bei der Anforderung um eine POST-Anforderung handelt. (Erstanfragen sind in der Regel GET-Anfragen.)

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, den Layoutseiten und den Teilseiten in der aktuellen Anforderung geteilt 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) Gibt den Inhalt einer Inhaltsseite ohne benannte Abschnitte wieder.

@RenderBody()

`RenderPage(path, values)`

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

Rendert eine Inhaltsseite mithilfe 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 required auf "false" fest, um einen Abschnitt optional zu gestalten.

@RenderSection("header")

`Request.Cookies[key]`

Dient zum Abrufen oder Festlegen des Werts eines HTTP-Cookies.

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 gepostet wurden (als Zeichenfolgen). Request[key] überprüft sowohl die Request.Form- als auch die Request.QueryString-Sammlungen.

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- als auch die Request.QueryString-Sammlungen.

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 bestimmte Zeit. Legen Sie optional `sliding` fest, um das Timeout bei jedem Seitenzugriff zurückzusetzen, und `varyByParams`, um für jede unterschiedliche Abfragezeichenfolge in der Seitenanforderung unterschiedliche Versionen der Seite im Cache zu speichern.

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-Statuscode fest, der an den Browser gesendet wird.

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

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

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

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 von einer URL.

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

`Server.UrlEncode(text)`

Codiert Text, der in eine URL gesetzt werden soll.

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

`Session[key]`

Dient zum Abrufen oder Festlegen eines Werts, der vorhanden ist, bis der Benutzer den Browser schließt.

Session["FavoriteColor"] = "red";

`ToString()`

Zeigt eine Zeichenfolgendarstellung des Werts des Objekts 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 aktuell 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])`

Meldet den Benutzer an, indem ein Authentifizierungstoken im Cookie gesetzt wird.

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

`WebSecurity.Logout()`

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

WebSecurity.Logout();

`WebSecurity.RequireAuthenticatedUser()`

Wenn der Benutzer nicht authentifiziert ist, wird der HTTP-Status auf 401 (Nicht autorisiert) festgelegt.

WebSecurity.RequireAuthenticatedUser();

`WebSecurity.RequireRoles(roles)`

Wenn der aktuelle Benutzer kein Mitglied einer der angegebenen Rollen ist, wird der HTTP-Status auf 401 (Nicht autorisiert) festgelegt.

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

`WebSecurity.RequireUser(userId)`

WebSecurity.RequireUser(userName)

Wenn der aktuelle Benutzer nicht der durch den Benutzernamen angegebene Benutzer ist, wird der HTTP-Status auf 401 (Nicht autorisiert) festgelegt.

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

`WebSecurity.ResetPassword(passwordResetToken,newPassword)`

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

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

Daten

`Database.Execute(SQLstatement [,parameters]`

Führt SQLstatement (mit optionalen Parametern) aus, z. B. INSERT, DELETE oder UPDATE, und gibt eine Anzahl betroffener 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 datenbank, die mit einer benannten Verbindungszeichenfolge aus der Web.config Datei angegeben wurde.

// 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, das eine Verbindungszeichenfolge verwendet.)

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

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

Fragt die Datenbank mithilfe von SQLstatement (optional übergebene Parameter) ab 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);

Helpers

`Analytics.GetGoogleHtml(webPropertyId)`

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

@Analytics.GetGoogleHtml("MyWebPropertyId")

`Analytics.GetStatCounterHtml(project,security)`

Rendert den JavaScript-Code StatCounter Analytics 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 website anzugeben, die durchsucht werden soll, und einen Titel für das Suchfeld, können Sie die Bing.SiteUrl Eigenschaften Bing.SiteTitle festlegen. Normalerweise legen Sie diese Eigenschaften auf der _AppStart Seite 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 Es 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)`

Zeigt den angegebenen Xbox-Gamertag.

@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 mithilfe des angegebenen Titels und optionaler 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 Mitglied 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 Mitglied zuzugreifen.

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

`ModelStateDictionary.IsValid`

Gibt "true" zurück, wenn keine Überprüfungsfehler aufgetreten sind. Verwenden Sie das ModelState Hilfsprogramm, um auf dieses Mitglied 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 _AppStart Seite 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 Statusinformationen zu ASP.NET Webseiten.

@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 erforderlicher Breite und Höhe.

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

`WebCache.Get(key)`

Gibt das durch 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 zum Anzeigen von Daten in einer HTML-Tabelle.

@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 Bild 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 Bild 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 _AppStart Seite 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 SMTP-Servernamen fest. Normalerweise legen Sie diese Eigenschaft auf der _AppStart Seite fest.

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

`WebMail.UserName`

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

WebMail.UserName = "Joe";

Überprüfung

`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 Überprüfungsfehler an.

@Html.ValidationSummary()

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

`Validation.Add(field, validationType)`

(v2) Registriert ein Benutzereingabeelement für den angegebenen Überprüfungstyp.

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 CSS-Klassenattribute für die clientseitige Überprüfung dynamisch, 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 Überprüfung 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 Überprüfung 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 bereitstellen müssen.

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

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

(v2) Gibt an, dass Benutzer Werte für jedes der Benutzereingabeelemente 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 Überprüfungstest 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."));

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-28

Freigeben über

Schnellreferenz zur API für ASP.NET-Webseiten („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)