Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Controller, classe

.NET Framework 4

Fournit des méthodes qui répondent aux requêtes HTTP envoyées à un site Web ASP.NET MVC.

Hiérarchie d'héritage

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

Espace de noms : System.Web.Mvc
Assembly : System.Web.Mvc (dans System.Web.Mvc.dll)

Syntaxe

C++

Copier

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

Le type Controller expose les membres suivants.

Constructeurs

	Nom	Description
	Controller	Initialise une nouvelle instance de la classe Controller.

Début

Propriétés

	Nom	Description
	ActionInvoker	Obtient le demandeur d'action du contrôleur.
	Binders	Obtient ou définit le classeur.
	ControllerContext	Obtient ou définit le contexte du contrôleur. (Hérité de ControllerBase.)
	HttpContext	Obtient des informations spécifiques à HTTP concernant une requête HTTP individuelle.
	ModelState	Obtient l'objet de dictionnaire d'états du modèle qui contient l'état du modèle et de la validation de liaison associée.
	Request	Obtient l'objet HttpRequestBase pour la requête HTTP en cours.
	Response	Obtient l'objet HttpResponseBase pour la réponse HTTP actuelle.
	RouteData	Obtient les données d'itinéraire de la requête actuelle.
	Server	Obtient l'objet HttpServerUtilityBase qui fournit les méthodes utilisées lors du traitement des requêtes Web.
	Session	Obtient l'objet HttpSessionStateBase pour la requête HTTP actuelle.
	TempData	Obtient ou définit le dictionnaire pour les données temporaires. (Hérité de ControllerBase.)
	TempDataProvider	Obtient l'objet fournisseur de données temporaires qui est utilisé pour stocker les données de la requête suivante.
	Url	Obtient l'objet d'assistance d'URL qui est utilisé pour générer des URL au moyen du routage.
	User	Obtient les informations sur la sécurité utilisateur pour la requête HTTP actuelle.
	ValidateRequest	Obtient ou définit une valeur qui indique si la validation de requête est activée pour cette requête. (Hérité de ControllerBase.)
	ValueProvider	Obtient ou définit le fournisseur de valeurs du contrôleur. (Hérité de ControllerBase.)
	ViewData	Obtient ou définit le dictionnaire pour les données d'affichage. (Hérité de ControllerBase.)

Début

Méthodes

	Nom	Description
	Content(String)	Crée un objet résultat de contenu à l'aide d'une chaîne.
	Content(String, String)	Crée un objet résultat de contenu à l'aide d'une chaîne et du type de contenu.
	Content(String, String, Encoding)	Crée un objet résultat de contenu à l'aide d'une chaîne, du type de contenu et de l'encodage du contenu.
	CreateActionInvoker	Crée un demandeur d'action.
	CreateTempDataProvider	Crée un fournisseur de données temporaire.
	Dispose()	Libère toutes les ressources qui sont utilisées par l'instance actuelle de la classe Controller.
	Dispose(Boolean)	Libère des ressources non managées et, le cas échéant, des ressources managées.
	Equals	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Execute	Exécute le contexte de la requête spécifiée. (Hérité de ControllerBase.)
	ExecuteCore	Appelle l'action dans le contexte de contrôleur actuel. (Substitue ControllerBase.ExecuteCore().)
	File(Byte[], String)	Crée un objet FileContentResult à l'aide du contenu du fichier et du type de fichier.
	File(Stream, String)	Crée un objet FileStreamResult à l'aide de l'objet Stream et du type de contenu.
	File(String, String)	Crée un objet FilePathResult à l'aide du nom du fichier et du type de contenu.
	File(Byte[], String, String)	Crée un objet FileContentResult à l'aide du contenu du fichier, du type de contenu et du nom du fichier de destination.
	File(Stream, String, String)	Crée un objet FileStreamResult à l'aide de l'objet Stream, du type de contenu et du nom du fichier cible.
	File(String, String, String)	Crée un objet FilePathResult à l'aide du nom du fichier, du type de contenu et du nom de téléchargement du fichier.
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	HandleUnknownAction	Méthode appelée lorsqu'une requête correspond à ce contrôleur, mais qu'aucune méthode portant le nom d'action spécifié n'est trouvée dans le contrôleur.
	Initialize	Initialise des données qui peuvent ne pas être disponibles lorsque le constructeur est appelé. (Substitue ControllerBase.Initialize(RequestContext).)
	JavaScript	Crée un objet JavaScriptResult.
	Json(Object)	Crée un objet JsonResult qui sérialise l'objet spécifié au format JSON (JavaScript Object Notation).
	Json(Object, String)	Crée un objet JsonResult qui sérialise l'objet spécifié au format JSON (JavaScript Object Notation).
	Json(Object, JsonRequestBehavior)	Crée un objet JsonResult qui sérialise l'objet spécifié au format JSON (JavaScript Object Notation) à l'aide du comportement de demande JSON spécifié.
	Json(Object, String, Encoding)	Crée un objet JsonResult qui sérialise l'objet spécifié au format JSON (JavaScript Object Notation).
	Json(Object, String, JsonRequestBehavior)	Crée un objet JsonResult qui sérialise l'objet spécifié au format JSON (JavaScript Object Notation) à l'aide du type de contenu et du comportement de demande JSON spécifiés.
	Json(Object, String, Encoding, JsonRequestBehavior)	Crée un objet JsonResult qui sérialise l'objet spécifié au format JSON (JavaScript Object Notation) à l'aide du type de contenu, de l'encodage du contenu et du comportement de demande JSON.
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnActionExecuted	Méthode appelée après la méthode d'action.
	OnActionExecuting	Méthode appelée avant la méthode d'action.
	OnAuthorization	Méthode appelée lors de l'autorisation.
	OnException	Méthode appelée lorsqu'une exception non gérée se produit au cours de l'action.
	OnResultExecuted	Méthode appelée après l'exécution du résultat d'action qui est retourné par une méthode d'action.
	OnResultExecuting	Méthode appelée avant l'exécution du résultat d'action qui est retourné par une méthode d'action.
	PartialView()	Crée un objet PartialViewResult qui restitue une vue partielle.
	PartialView(Object)	Crée un objet PartialViewResult qui restitue une vue partielle à l'aide du modèle spécifié.
	PartialView(String)	Crée un objet PartialViewResult qui restitue une vue partielle à l'aide du nom de vue spécifié.
	PartialView(String, Object)	Crée un objet PartialViewResult qui restitue une vue partielle à l'aide du modèle et du nom de vue spécifiés.
	Redirect	Crée un objet RedirectResult qui effectue une redirection vers l'URL spécifiée.
	RedirectToAction(String)	Effectue une redirection vers l'action spécifiée à l'aide du nom d'action.
	RedirectToAction(String, Object)	Effectue une redirection vers l'action spécifiée à l'aide du nom d'action et des valeurs d'itinéraire.
	RedirectToAction(String, String)	Effectue une redirection vers l'action spécifiée à l'aide du nom d'action et du nom de contrôleur.
	RedirectToAction(String, RouteValueDictionary)	Effectue une redirection vers l'action spécifiée à l'aide du nom d'action et du dictionnaire d'itinéraires.
	RedirectToAction(String, String, Object)	Effectue une redirection vers l'action spécifiée à l'aide du nom d'action, du nom de contrôleur et des valeurs d'itinéraire.
	RedirectToAction(String, String, RouteValueDictionary)	Effectue une redirection vers l'action spécifiée à l'aide du nom d'action, du nom de contrôleur et du dictionnaire d'itinéraires.
	RedirectToRoute(Object)	Effectue une redirection vers l'itinéraire spécifié à l'aide des valeurs d'itinéraire indiquées.
	RedirectToRoute(String)	Effectue une redirection vers l'itinéraire spécifié à l'aide du nom d'itinéraire.
	RedirectToRoute(RouteValueDictionary)	Effectue une redirection vers l'itinéraire spécifié à l'aide du dictionnaire d'itinéraires.
	RedirectToRoute(String, Object)	Effectue une redirection vers l'itinéraire spécifié à l'aide du nom d'itinéraire et des valeurs d'itinéraire.
	RedirectToRoute(String, RouteValueDictionary)	Effectue une redirection vers l'itinéraire spécifié à l'aide du nom d'itinéraire et du dictionnaire d'itinéraires.
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
	TryUpdateModel<TModel>(TModel)	Met à jour l'instance de modèle spécifiée à l'aide de valeurs provenant du fournisseur de valeur actuel du contrôleur.
	TryUpdateModel<TModel>(TModel, String)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur et un préfixe.
	TryUpdateModel<TModel>(TModel, String[])	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur et des propriétés incluses.
	TryUpdateModel<TModel>(TModel, IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs.
	TryUpdateModel<TModel>(TModel, String, String[])	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur, un préfixe et des propriétés incluses.
	TryUpdateModel<TModel>(TModel, String, IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs et un préfixe.
	TryUpdateModel<TModel>(TModel, String[], IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs et une liste des propriétés à inclure.
	TryUpdateModel<TModel>(TModel, String, String[], String[])	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur, un préfixe, une liste des propriétés à exclure et une liste des propriétés à inclure.
	TryUpdateModel<TModel>(TModel, String, String[], IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs, un préfixe et des propriétés incluses.
	TryUpdateModel<TModel>(TModel, String, String[], String[], IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs, un préfixe, une liste des propriétés à exclure et une liste des propriétés à inclure.
	TryValidateModel(Object)	Valide l'instance de modèle spécifiée.
	TryValidateModel(Object, String)	Valide l'instance de modèle spécifiée à l'aide d'un préfixe HTML.
	UpdateModel<TModel>(TModel)	Met à jour l'instance de modèle spécifiée à l'aide de valeurs provenant du fournisseur de valeur actuel du contrôleur.
	UpdateModel<TModel>(TModel, String)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur et un préfixe.
	UpdateModel<TModel>(TModel, String[])	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel de l'objet contrôleur.
	UpdateModel<TModel>(TModel, IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs.
	UpdateModel<TModel>(TModel, String, String[])	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur, un préfixe et des propriétés incluses.
	UpdateModel<TModel>(TModel, String, IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs et un préfixe.
	UpdateModel<TModel>(TModel, String[], IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs, un préfixe et une liste des propriétés à inclure.
	UpdateModel<TModel>(TModel, String, String[], String[])	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs actuel du contrôleur, un préfixe, une liste des propriétés à exclure et une liste des propriétés à inclure.
	UpdateModel<TModel>(TModel, String, String[], IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs, un préfixe et une liste des propriétés à inclure.
	UpdateModel<TModel>(TModel, String, String[], String[], IValueProvider)	Met à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs, un préfixe, une liste des propriétés à exclure et une liste des propriétés à inclure.
	ValidateModel(Object)	Valide l'instance de modèle spécifiée.
	ValidateModel(Object, String)	Valide l'instance de modèle spécifiée à l'aide d'un préfixe HTML.
	View()	Crée un objet ViewResult qui restitue une vue dans la réponse.
	View(Object)	Crée un objet ViewResult à l'aide du modèle qui restitue une vue dans la réponse.
	View(String)	Crée un objet ViewResult à l'aide du nom de vue qui restitue une vue.
	View(IView)	Crée un objet ViewResult qui restitue l'objet IView spécifié.
	View(String, Object)	Crée un objet ViewResult à l'aide du nom de vue et du modèle qui restituent une vue dans la réponse.
	View(String, String)	Crée un objet ViewResult à l'aide du nom de vue et du nom de page maître qui restituent une vue dans la réponse.
	View(IView, Object)	Crée un objet ViewResult qui restitue l'objet IView spécifié.
	View(String, String, Object)	Crée un objet ViewResult à l'aide du nom de vue, du nom de page maître et du modèle qui restituent une vue.

Début

Implémentations d'interface explicite

	Nom	Description
	IActionFilter.OnActionExecuted	Cette API prend en charge l'infrastructure MVC et n'est pas conçue pour être utilisée directement à partir de votre code. Cette méthode appelle la méthode OnActionExecuted.
	IActionFilter.OnActionExecuting	Cette API prend en charge l'infrastructure MVC et n'est pas conçue pour être utilisée directement à partir de votre code. Cette méthode appelle la méthode OnActionExecuting.
	IAuthorizationFilter.OnAuthorization	Cette API prend en charge l'infrastructure MVC et n'est pas conçue pour être utilisée directement à partir de votre code. Cette méthode appelle la méthode OnAuthorization.
	IController.Execute	Exécute le contexte de la requête spécifiée. (Hérité de ControllerBase.)
	IExceptionFilter.OnException	Cette API prend en charge l'infrastructure MVC et n'est pas conçue pour être utilisée directement à partir de votre code. Cette méthode appelle la méthode OnException.
	IResultFilter.OnResultExecuted	Cette API prend en charge l'infrastructure MVC et n'est pas conçue pour être utilisée directement à partir de votre code. Cette méthode appelle la méthode OnResultExecuted.
	IResultFilter.OnResultExecuting	Cette API prend en charge l'infrastructure MVC et n'est pas conçue pour être utilisée directement à partir de votre code. Cette méthode appelle la méthode OnResultExecuting.

Début

Notes

Un nom de la classe contrôleur doit se terminer par « Controller ». Par exemple, un contrôleur de Produit peut être nommé ProductController mais pas Product ou ProductCtrl.

Les méthodes d'action de contrôleur répondent aux demandes envoyées au contrôleur. Les méthodes d'action de contrôleur ont les restrictions suivantes :

Les méthodes d'action doivent être publiques.
Les méthodes d'action ne peuvent pas être statiques.
Les méthodes d'action ne peuvent pas avoir de paramètres de type générique unbounded. Un paramètre de type générique unbounded a une liste de paramètres vide. Un type générique unbounded est également appelé type générique ouvert. Pour plus d'informations sur les paramètres de type générique unbounded, consultez la section « Paramètres de type unbounded » dans Contraintes sur les paramètres de type (Guide de programmation C#).
Les méthodes d'action ne peuvent pas être surchargées selon les paramètres. Les méthodes d'action peuvent être surchargées lorsqu'elles sont désambiguïsés avec les attributs tels que NonActionAttribute ou AcceptVerbsAttribute.

Le tableau suivant répertorie les types qu'une méthode d'action de contrôleur peut retourner et les scénarios pour lesquels les types sont retournés.

Type de retour	Retour de l'action de contrôle
void or null	L'objet ControllerActionInvoker retourne un objet EmptyResult.
ActionResult	L'objet ControllerActionInvoker appelle la méthode ExecuteResult sur le résultat.
Object (à l'exclusion de ActionResult)	Le résultat est passé à un CreateActionResult, qui crée un objet ContentResult. La méthode Content de l'objet ContentResult a pour valeur la représentation sous forme de chaîne invariant de l'objet retourné.

Exemples

Un projet Visual Studio (avec code source) est disponible pour accompagner cette rubrique : Download.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

System.Web.Mvc, espace de noms

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Contenu de la communauté Ajouter

FAQ