Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Controller-Klasse

Andere Versionen

.NET Framework 4

Stellt Methoden bereit, die auf HTTP-Anforderungen an eine ASP.NET MVC-Website reagieren.

Vererbungshierarchie

System.Object
  System.Web.Mvc.ControllerBase
    System.Web.Mvc.Controller
      System.Web.Mvc.AsyncController

Namespace: System.Web.Mvc
Assembly: System.Web.Mvc (in System.Web.Mvc.dll)

Syntax

C++

JScript

public abstract class Controller : ControllerBase, 
	IActionFilter, IAuthorizationFilter, IDisposable, IExceptionFilter, IResultFilter

Der Controller-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	Controller	Initialisiert eine neue Instanz der Controller-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	ActionInvoker	Ruft die Instanz zum Aufrufen der Aktion für den Controller ab.
	Binders	Ruft den Binder ab oder legt ihn fest.
	ControllerContext	Ruft den Controllerkontext ab bzw. legt ihn fest. (Von ControllerBase geerbt.)
	HttpContext	Ruft HTTP-spezifische Informationen zu einer einzelnen HTTP-Anforderung ab.
	ModelState	Ruft das Modellzustandswörterbuch ab, das den Zustand des Modells und der Modellbindungs-Validierung enthält.
	Request	Ruft das HttpRequestBase-Objekt für die aktuelle HTTP-Anforderung ab.
	Response	Ruft das HttpResponseBase-Objekt für die aktuelle HTTP-Antwort ab.
	RouteData	Ruft die Routendaten für die aktuelle Anforderung ab.
	Server	Ruft das HttpServerUtilityBase-Objekt ab, das die bei der Verarbeitung von Webanforderungen verwendeten Methoden bereitstellt.
	Session	Ruft das HttpSessionStateBase-Objekt für die aktuelle HTTP-Anforderung ab.
	TempData	Ruft das Wörterbuch für temporäre Daten ab bzw. legt es fest. (Von ControllerBase geerbt.)
	TempDataProvider	Ruft das temporäre Datenanbieterobjekt ab, das verwendet wird, um Daten für die nächste Anforderung zu speichern.
	Url	Ruft das URL-Hilfsobjekt ab, mit dem URLs mithilfe von Routing generiert werden.
	User	Ruft die Sicherheitsinformationen des Benutzers für die aktuelle HTTP-Anforderung ab.
	ValidateRequest	Ruft einen Wert ab, der angibt, ob die Anforderungsvalidierung für diese Anforderung aktiviert ist, oder legt diesen fest. (Von ControllerBase geerbt.)
	ValueProvider	Ruft den Wertanbieter für den Controller ab bzw. legt diesen fest. (Von ControllerBase geerbt.)
	ViewBag	Ruft das Wörterbuch mit den dynamischen Ansichtsdaten ab. (Von ControllerBase geerbt.)
	ViewData	Ruft das Wörterbuch für Ansichtsdaten ab bzw. legt es fest. (Von ControllerBase geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Content(String)	Erstellt mit einer Zeichenfolge ein Inhaltsergebnisobjekt.
	Content(String, String)	Erstellt ein Inhaltsergebnisobjekt anhand einer Zeichenfolge und des Inhaltstyps.
	Content(String, String, Encoding)	Erstellt ein Inhaltsergebnisobjekt. Verwendet hierfür eine Zeichenfolge, den Inhaltstyp und die Inhaltscodierung.
	CreateActionInvoker	Erstellt eine Instanz zum Aufrufen einer Aktion.
	CreateTempDataProvider	Erstellt einen temporären Datenanbieter.
	Dispose()	Gibt alle von der aktuellen Instanz der Controller-Klasse verwendeten Ressourcen frei.
	Dispose(Boolean)	Gibt nicht verwaltete Ressourcen und optional verwaltete Ressourcen frei.
	Equals	(Von Object geerbt.)
	Execute	Führt den angegebenen Anforderungskontext aus. (Von ControllerBase geerbt.)
	ExecuteCore	Ruft die Aktion im aktuellen Controllerkontext auf. (Überschreibt ControllerBase.ExecuteCore().)
	File(Byte[], String)	Erstellt auf Grundlage von Dateiinhalt und Dateityp ein FileContentResult-Objekt.
	File(Stream, String)	Erstellt auf Grundlage des Stream-Objekts und des Inhaltstyps ein FileStreamResult-Objekt.
	File(String, String)	Erstellt auf Grundlage von Dateiname und Inhaltstyp ein FilePathResult-Objekt.
	File(Byte[], String, String)	Erstellt auf Grundlage des Dateiinhalts, Inhaltstyps und Zieldateinamens ein FileContentResult-Objekt.
	File(Stream, String, String)	Erstellt auf Grundlage des Stream-Objekts, des Inhaltstyps und des Zieldateinamens ein FileStreamResult-Objekt.
	File(String, String, String)	Erstellt auf Grundlage von Dateiname, Inhaltstyp und Name des Dateidownloads ein FilePathResult-Objekt.
	Finalize	(Von Object geerbt.)
	GetHashCode	(Von Object geerbt.)
	GetType	(Von Object geerbt.)
	HandleUnknownAction	Wird aufgerufen, wenn eine Anforderung zu diesem Controller passt, aber keine Methode mit dem angegebenen Aktionsnamen im Controller gefunden wird.
	HttpNotFound()	Gibt eine Instanz der HttpNotFoundResult-Klasse zurück.
	HttpNotFound(String)	Gibt eine Instanz der HttpNotFoundResult-Klasse zurück.
	Initialize	Initialisiert Daten, die beim Aufrufen des Konstruktors möglicherweise nicht verfügbar sind. (Überschreibt ControllerBase.Initialize(RequestContext).)
	JavaScript	Erstellt ein JavaScriptResult-Objekt.
	Json(Object)	Erstellt ein JsonResult-Objekt, das das angegebene Objekt in JSON (JavaScript Object Notation) serialisiert.
	Json(Object, String)	Erstellt ein JsonResult-Objekt, das das angegebene Objekt in das JSON-Format (JavaScript Object Notation) serialisiert.
	Json(Object, JsonRequestBehavior)	Erstellt ein JsonResult-Objekt, das das angegebene Objekt in das JSON-Format (JavaScript Object Notation) serialisiert und dazu das angegebene JSON-Anforderungsverhalten verwendet.
	Json(Object, String, Encoding)	Erstellt ein JsonResult-Objekt, das das angegebene Objekt in das JSON-Format (JavaScript Object Notation) serialisiert.
	Json(Object, String, JsonRequestBehavior)	Erstellt ein JsonResult-Objekt, das das angegebene Objekt in das JSON-Format (JavaScript Object Notation) serialisiert und dazu den angegebenen Inhaltstyp und das angegebene JSON-Anforderungsverhalten verwendet.
	Json(Object, String, Encoding, JsonRequestBehavior)	Erstellt ein JsonResult-Objekt, das das angegebene Objekt in das JSON-Format (JavaScript Object Notation) serialisiert und dazu den Inhaltstyp, die Inhaltscodierung und das JSON-Anforderungsverhalten verwendet.
	MemberwiseClone	(Von Object geerbt.)
	OnActionExecuted	Wird aufgerufen, nachdem die Aktionsmethode aufgerufen wurde.
	OnActionExecuting	Wird aufgerufen, bevor die Aktionsmethode aufgerufen wird.
	OnAuthorization	Wird aufgerufen, wenn eine Autorisierung auftritt.
	OnException	Wird aufgerufen, wenn in der Aktion eine nicht behandelte Ausnahme auftritt.
	OnResultExecuted	Wird aufgerufen, nachdem das von einer Aktionsmethode zurückgegebene Aktionsergebnis ausgeführt wurde.
	OnResultExecuting	Wird aufgerufen, bevor das von einer Aktionsmethode zurückgegebene Aktionsergebnis ausgeführt wurde.
	PartialView()	Erstellt ein PartialViewResult-Objekt, das eine partielle Ansicht rendert.
	PartialView(Object)	Erstellt anhand des angegebenen Modells ein PartialViewResult-Objekt, das eine Teilansicht rendert.
	PartialView(String)	Erstellt anhand der angegebenen Ansicht ein PartialViewResult-Objekt, das eine Teilansicht rendert.
	PartialView(String, Object)	Erstellt anhand der angegebenen Ansicht und des angegebenen Modells ein PartialViewResult-Objekt, das eine Teilansicht rendert.
	Redirect	Erstellt ein RedirectResult-Objekt, das zur angegebenen URL umleitet.
	RedirectPermanent	Gibt eine Instanz der RedirectResult-Klasse zurück, bei der die Permanent-Eigenschaft auf true festgelegt ist.
	RedirectToAction(String)	Leitet anhand des Aktionsnamens zur angegebenen Aktion um.
	RedirectToAction(String, Object)	Leitet anhand des Aktionsnamens und der Routenwerte zur angegebenen Aktion um.
	RedirectToAction(String, String)	Leitet anhand des Aktions- und Controllernamens zur angegebenen Aktion um.
	RedirectToAction(String, RouteValueDictionary)	Leitet anhand des Aktionsnamens und des Routenwörterbuchs zur angegebenen Aktion um.
	RedirectToAction(String, String, Object)	Leitet anhand des Aktionsnamens, des Controller-Namens und der Routenwerte zur angegebenen Aktion um.
	RedirectToAction(String, String, RouteValueDictionary)	Leitet anhand des Aktionsnamens, des Controller-Namens und der Routenbibliothek zur angegebenen Aktion um.
	RedirectToActionPermanent(String)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung des angegebenen Aktionsnamens auf true festgelegt wurde.
	RedirectToActionPermanent(String, Object)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung des angegebenen Aktionsnamens und der Routenwerte auf true festgelegt wurde.
	RedirectToActionPermanent(String, String)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung des angegebenen Aktionsnamens und des Controllernamens auf true festgelegt wurde.
	RedirectToActionPermanent(String, RouteValueDictionary)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung des angegebenen Aktionsnamens und der Routenwerte auf true festgelegt wurde.
	RedirectToActionPermanent(String, String, Object)	Gibt mithilfe des angegebenen Aktionsnamens, des angegebenen Controllernamens und der angegebenen Routenwerte eine Instanz der RedirectResult-Klasse zurück, bei der die Permanent-Eigenschaft auf true festgelegt ist.
	RedirectToActionPermanent(String, String, RouteValueDictionary)	Gibt mithilfe des angegebenen Aktionsnamens, des angegebenen Controllernamens und der angegebenen Routenwerte eine Instanz der RedirectResult-Klasse zurück, bei der die Permanent-Eigenschaft auf true festgelegt ist.
	RedirectToRoute(Object)	Leitet anhand der angegebenen Routenwerte zur angegebenen Route um.
	RedirectToRoute(String)	Leitet anhand des Routennamens zur angegebenen Route um.
	RedirectToRoute(RouteValueDictionary)	Leitet anhand des Routenwörterbuchs zur angegebenen Route um.
	RedirectToRoute(String, Object)	Leitet anhand des Routennamens und der Routenwerte zur angegebenen Route um.
	RedirectToRoute(String, RouteValueDictionary)	Leitet anhand des Routennamens und des Routenwörterbuchs zur angegebenen Aktion um.
	RedirectToRoutePermanent(Object)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung der angegebenen Routenwerte auf true festgelegt wurde.
	RedirectToRoutePermanent(String)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung des angegebenen Routennamens auf true festgelegt wurde.
	RedirectToRoutePermanent(RouteValueDictionary)	Gibt eine Instanz der RedirectResult-Klasse zurück, deren Permanent-Eigenschaft unter Verwendung der angegebenen Routenwerte auf true festgelegt wurde.
	RedirectToRoutePermanent(String, Object)	Gibt mithilfe des angegebenen Routennamens und der angegebenen Routenwerte eine Instanz der RedirectResult-Klasse zurück, bei der die Permanent-Eigenschaft auf true festgelegt ist.
	RedirectToRoutePermanent(String, RouteValueDictionary)	Gibt mithilfe des angegebenen Routennamens und der angegebenen Routenwerte eine Instanz der RedirectResult-Klasse zurück, bei der die Permanent-Eigenschaft auf true festgelegt ist.
	ToString	(Von Object geerbt.)
	TryUpdateModel<TModel>(TModel)	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers.
	TryUpdateModel<TModel>(TModel, String)	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers und einem Präfix.
	TryUpdateModel<TModel>(TModel, String[])	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers und enthaltenen Eigenschaften.
	TryUpdateModel<TModel>(TModel, IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter.
	TryUpdateModel<TModel>(TModel, String, String[])	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers, einem Präfix und enthaltenen Eigenschaften.
	TryUpdateModel<TModel>(TModel, String, IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter und einem Präfix.
	TryUpdateModel<TModel>(TModel, String[], IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter sowie einer Liste einzuschließender Eigenschaften.
	TryUpdateModel<TModel>(TModel, String, String[], String[])	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers, einem Präfix sowie einer Liste auszuschließender und einer Liste einzuschließender Eigenschaften.
	TryUpdateModel<TModel>(TModel, String, String[], IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter, einem Präfix und enthaltenen Eigenschaften.
	TryUpdateModel<TModel>(TModel, String, String[], String[], IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter, einem Präfix, einer Liste auszuschließender und einer Liste einzuschließender Eigenschaften.
	TryValidateModel(Object)	Überprüft die angegebene Modellinstanz.
	TryValidateModel(Object, String)	Überprüft die angegebene Modellinstanz mit einem HTML-Präfix.
	UpdateModel<TModel>(TModel)	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers.
	UpdateModel<TModel>(TModel, String)	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers und einem Präfix.
	UpdateModel<TModel>(TModel, String[])	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllerobjekts.
	UpdateModel<TModel>(TModel, IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter.
	UpdateModel<TModel>(TModel, String, String[])	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers, einem Präfix und enthaltenen Eigenschaften.
	UpdateModel<TModel>(TModel, String, IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter und einem Präfix.
	UpdateModel<TModel>(TModel, String[], IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter, einem Präfix sowie einer Liste einzuschließender Eigenschaften.
	UpdateModel<TModel>(TModel, String, String[], String[])	Aktualisiert die angegebene Modellinstanz mit Werten vom aktuellen Wertanbieter des Controllers, einem Präfix sowie einer Liste auszuschließender und einzuschließender Eigenschaften.
	UpdateModel<TModel>(TModel, String, String[], IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter, einem Präfix sowie einer Liste einzuschließender Eigenschaften.
	UpdateModel<TModel>(TModel, String, String[], String[], IValueProvider)	Aktualisiert die angegebene Modellinstanz mit Werten vom Wertanbieter, einem Präfix, einer Liste auszuschließender und einer Liste einzuschließender Eigenschaften.
	ValidateModel(Object)	Überprüft die angegebene Modellinstanz.
	ValidateModel(Object, String)	Überprüft die angegebene Modellinstanz mit einem HTML-Präfix.
	View()	Erstellt ein ViewResult-Objekt, das eine Ansicht für die Antwort rendert.
	View(Object)	Erstellt ein ViewResult-Objekt mit dem Modell, das eine Ansicht für die Antwort rendert.
	View(String)	Erstellt anhand des Ansichtsnamens ein ViewResult-Objekt, das eine Ansicht rendert.
	View(IView)	Erstellt ein ViewResult-Objekt, das das angegebene IView-Objekt rendert.
	View(String, Object)	Erstellt anhand des Ansichtsnamens und Modells ein ViewResult-Objekt, das eine Ansicht für die Antwort rendert.
	View(String, String)	Erstellt anhand des Namens der Ansicht und der Gestaltungsvorlage ein ViewResult-Objekt, das eine Ansicht für die Antwort rendert.
	View(IView, Object)	Erstellt ein ViewResult-Objekt, das das angegebene IView-Objekt rendert.
	View(String, String, Object)	Erstellt anhand des Namens der Ansicht, der Gestaltungsvorlage und des Modells ein ViewResult-Objekt, das eine Ansicht rendert.

Zum Seitenanfang

Explizite Schnittstellen implementierungen

	Name	Beschreibung
	IActionFilter.OnActionExecuted	Diese API unterstützt die ASP.NET MVC-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. Diese Methode ruft die OnActionExecuted-Methode auf.
	IActionFilter.OnActionExecuting	Diese API unterstützt die ASP.NET MVC-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. Diese Methode ruft die OnActionExecuting-Methode auf.
	IAuthorizationFilter.OnAuthorization	Diese API unterstützt die ASP.NET MVC-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. Diese Methode ruft die OnAuthorization-Methode auf.
	IController.Execute	Führt den angegebenen Anforderungskontext aus. (Von ControllerBase geerbt.)
	IExceptionFilter.OnException	Diese API unterstützt die ASP.NET MVC-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. Diese Methode ruft die OnException-Methode auf.
	IResultFilter.OnResultExecuted	Diese API unterstützt die ASP.NET MVC-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. Diese Methode ruft die OnResultExecuted-Methode auf.
	IResultFilter.OnResultExecuting	Diese API unterstützt die ASP.NET MVC-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. Diese Methode ruft die OnResultExecuting-Methode auf.

Zum Seitenanfang

Hinweise

A controller class name must end with "Controller". For example, a Product controller can be named ProductController but not Product or ProductCtrl.

Controller action methods respond to requests that are sent to the controller. Controller action methods have the following restrictions:

Action methods must be public.
Action methods cannot be static.
Action methods cannot have unbounded generic type parameters. An unbounded generic type parameter has an empty parameter list. An unbounded generic type is also known as an open generic type. For information about unbounded generic type parameters, see the section "Unbounded Type Parameters" in Constraints on Type Parameters.
Action methods cannot be overloaded based on parameters. Action methods can be overloaded when they are disambiguated with attributes such as NonActionAttribute or AcceptVerbsAttribute.

The following table lists the types that a controller action method can return and the scenarios for which the types are returned.

Return type	Control action return
void or null	The ControllerActionInvoker object returns an EmptyResult object.
ActionResult	The ControllerActionInvoker object calls the ExecuteResult method on the result.
Object (excluding ActionResult)	The result is passed to a CreateActionResult, which creates a new ContentResult object. The Content method of the ContentResult object is set to the invariant string representation of the returned object.

Beispiele

A Visual Studio project with source code is available to accompany this topic: Download.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Web.Mvc-Namespace

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?

Informationen zur Datensicherheit