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
|
FormView, classe
Affiche les valeurs d'un enregistrement unique provenant d'une source de données qui utilise des modèles définis par l'utilisateur. Le contrôle FormView vous permet de modifier, de supprimer et d'insérer des enregistrements.
Assembly : System.Web (dans System.Web.dll)
Le type FormView expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
AccessKey | Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl.) |
|
Adapter | Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.) |
|
AllowPaging | Obtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée. |
|
AppRelativeTemplateSourceDirectory | Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control.) |
|
Attributes | Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl.) |
|
BackColor | Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.) |
|
BackImageUrl | Obtient ou définit l'URL d'une image à afficher à l'arrière-plan d'un contrôle FormView. |
|
BindingContainer | Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.) |
|
BorderColor | Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.) |
|
BorderStyle | Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.) |
|
BorderWidth | Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.) |
|
BottomPagerRow | Obtient l'objet FormViewRow qui représente la ligne de pagineur affichée en bas du contrôle FormView. |
|
Caption | Obtient ou définit le texte à afficher dans un élément de légende HTML d'un contrôle FormView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance. |
|
CaptionAlign | Obtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle FormView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance. |
|
CellPadding | Obtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci. |
|
CellSpacing | Obtient ou définit l'espace entre les cellules. |
|
ChildControlsCreated | Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.) |
|
ClientID | Obtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.) |
|
ClientIDMode | Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.) |
|
ClientIDSeparator | Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control.) |
|
Context | Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.) |
|
Controls | Obtient une collection de contrôles enfants dans le contrôle composite lié aux données. (Hérité de CompositeDataBoundControl.) |
|
ControlStyle | Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ControlStyleCreated | Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
CssClass | Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl.) |
|
CurrentMode | Obtient le mode d'entrée des données actuel du contrôle FormView. |
|
DataItem | Obtient l'élément de données lié au contrôle FormView. |
|
DataItemContainer | Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.) |
|
DataItemCount | Obtient le nombre d'éléments de données dans la source de données. |
|
DataItemIndex | Obtient l'index de l'élément de données lié au contrôle FormView de la source de données. |
|
DataKey | Obtient un objet DataKey qui représente la clé primaire de l'enregistrement affiché. |
|
DataKeyNames | Obtient ou définit un tableau qui contient les noms des champs clés pour la source de données. |
|
DataKeysContainer | Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.) |
|
DataMember | Obtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données. (Hérité de DataBoundControl.) |
|
DataSource | Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de BaseDataBoundControl.) |
|
DataSourceID | Obtient ou définit l'ID du contrôle duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de DataBoundControl.) |
|
DataSourceObject | Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet. (Hérité de DataBoundControl.) |
|
DefaultMode | Obtient ou définit le mode d'entrée des données dans lequel le contrôle FormView retourne après une opération de mise à jour, d'insertion ou d'annulation. |
|
DesignMode | Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.) |
|
EditItemTemplate | Obtient ou définit le contenu personnalisé d'un élément en mode édition. |
|
EditRowStyle | Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données lorsqu'un contrôle FormView est en mode édition. |
|
EmptyDataRowStyle | Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données vide affichée lorsque la source de données liée à un contrôle FormView ne contient pas d'enregistrements. |
|
EmptyDataTemplate | Obtient ou définit le contenu défini par l'utilisateur de la ligne de données vide rendue lorsqu'un contrôle FormView est lié à une source de données qui ne contient pas d'enregistrements. |
|
EmptyDataText | Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle FormView est lié à une source de données qui ne contient pas d'enregistrements. |
|
Enabled | Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.) |
|
EnableModelValidation | Obtient ou définit une valeur qui indique si un contrôle de validateur doit gérer les exceptions susceptibles de se produire lors des opérations d'insertion ou de mise à jour. |
|
EnableTheming | Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.) |
|
EnableViewState | Obtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (Hérité de Control.) |
|
Events | Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.) |
|
Font | Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.) |
|
FooterRow | Obtient l'objet FormViewRow qui représente la ligne de pied de page dans un contrôle FormView. |
|
FooterStyle | Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pied de page dans un contrôle FormView. |
|
FooterTemplate | Obtient ou définit le contenu défini par l'utilisateur pour la ligne de pied de page dans un contrôle FormView. |
|
FooterText | Obtient ou définit le texte à afficher dans la ligne de pied de page d'un contrôle FormView. |
|
ForeColor | Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl.) |
|
GridLines | Obtient ou définit le style de quadrillage d'un contrôle FormView. |
|
HasAttributes | Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.) |
|
HasChildViewState | Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control.) |
|
HeaderRow | Obtient l'objet FormViewRow qui représente la ligne d'en-tête dans un contrôle FormView. |
|
HeaderStyle | Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne d'en-tête dans un contrôle FormView. |
|
HeaderTemplate | Obtient ou définit le contenu défini par l'utilisateur pour la ligne d'en-tête dans un contrôle FormView. |
|
HeaderText | Obtient ou définit le texte à afficher dans la ligne d'en-tête d'un contrôle FormView. |
|
Height | Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.) |
|
HorizontalAlign | Obtient ou définit l'alignement horizontal d'un contrôle FormView sur la page. |
|
ID | Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.) |
|
IdSeparator | Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.) |
|
Initialized | Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl.) |
|
InsertItemTemplate | Obtient ou définit le contenu personnalisé d'un élément en mode insertion. |
|
InsertRowStyle | Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données dans un contrôle FormView lorsque le contrôle est en mode insertion. |
|
IsBoundUsingDataSourceID | Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl.) |
|
IsChildControlStateCleared | Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.) |
|
IsEnabled | Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.) |
|
IsTrackingViewState | Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.) |
|
IsViewStateEnabled | Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.) |
|
ItemTemplate | Obtient ou définit le contenu personnalisé pour la ligne de données dans un contrôle FormView lorsque le contrôle est en mode lecture seule. |
|
LoadViewStateByID | Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control.) |
|
NamingContainer | Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété Control.ID possède la même valeur. (Hérité de Control.) |
|
Page | Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.) |
|
PageCount | Obtient le nombre total de pages requises pour afficher tous les enregistrements de la source de données. |
|
PageIndex | Obtient ou définit l'index de la page affichée. |
|
PagerSettings | Obtient une référence à l'objet PagerSettings vous permettant de définir les propriétés des boutons du pagineur dans un contrôle FormView. |
|
PagerStyle | Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pagineur dans un contrôle FormView. |
|
PagerTemplate | Obtient ou définit le contenu personnalisé de la ligne de pagineur dans un contrôle FormView. |
|
Parent | Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.) |
|
RenderingCompatibility | Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.) |
|
RenderOuterTable | Obtient ou définit une valeur qui indique si le contrôle intègre le HTML restitué dans un élément table pour lui appliquer des styles intralignes. |
|
RequiresDataBinding | Obtient ou définit une valeur indiquant si la méthode DataBind doit être appelée. (Hérité de BaseDataBoundControl.) |
|
Row | Obtient l'objet FormViewRow qui représente la ligne de données dans un contrôle FormView. |
|
RowStyle | Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données dans un contrôle FormView lorsque le contrôle est en mode lecture seule. |
|
SelectArguments | Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données à partir d'un contrôle de source de données. (Hérité de DataBoundControl.) |
|
SelectedValue | Obtient la valeur de clés des données de l'enregistrement en cours dans un contrôle FormView. |
|
Site | Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control.) |
|
SkinID | Obtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.) |
|
Style | Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl.) |
|
SupportsDisabledAttribute | Obtient une valeur qui indique si le contrôle doit affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque la propriété IsEnabled du contrôle a la valeur false. (Hérité de BaseDataBoundControl.) |
|
TabIndex | Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.) |
|
TagKey | Obtient la valeur HtmlTextWriterTag du contrôle FormView. (Substitue WebControl.TagKey.) |
|
TagName | Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
TemplateControl | Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.) |
|
TemplateSourceDirectory | Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.) |
|
ToolTip | Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl.) |
|
TopPagerRow | Obtient l'objet FormViewRow qui représente la ligne de pagineur affichée en haut d'un contrôle FormView. |
|
UniqueID | Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.) |
|
ViewState | Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.) |
|
ViewStateIgnoresCase | Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.) |
|
ViewStateMode | Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.) |
|
Visible | Obtient ou définit une valeur qui indique si un contrôle serveur est rendu sous la forme d'une interface utilisateur sur la page. (Hérité de Control.) |
|
Width | Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.) |
| Nom | Description | |
|---|---|---|
|
AddAttributesToRender | Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
AddedControl | Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.) |
|
AddParsedSubObject | Avertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.) |
|
ApplyStyle | Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ApplyStyleSheetSkin | Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control.) |
|
BuildProfileTree | Infrastructure. Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.) |
|
ChangeMode | Bascule le contrôle FormView en mode d'entrée des données spécifié. |
|
ClearCachedClientID | Infrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.) |
|
ClearChildControlState | Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
ClearChildState | Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
ClearChildViewState | Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
ClearEffectiveClientIDMode | Infrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.) |
|
ConfirmInitState | Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl.) |
|
CopyBaseAttributes | Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
CreateChildControls() | Infrastructure. Crée la hiérarchie des contrôles utilisée pour restituer un contrôle composite lié aux données basé sur les valeurs qui sont stockées dans l'état d'affichage. (Hérité de CompositeDataBoundControl.) |
|
CreateChildControls(IEnumerable, Boolean) | Crée la hiérarchie des contrôles utilisée pour rendre le contrôle FormView à l'aide de la source de données spécifiée. (Substitue CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean).) |
|
CreateControlCollection | Crée un nouvel objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control.) |
|
CreateControlStyle | Crée un objet de style de tableau par défaut pour le contrôle FormView. (Substitue WebControl.CreateControlStyle().) |
|
CreateDataSourceSelectArguments | Crée l'objet DataSourceSelectArguments qui contient les arguments passés à la source de données pour être traités. (Substitue DataBoundControl.CreateDataSourceSelectArguments().) |
|
CreateRow | Crée un objet FormViewRow à l'aide de l'index de l'élément, du type de ligne et de l'état de ligne spécifiés. |
|
CreateTable | Crée la table conteneur pour le contrôle FormView. |
|
DataBind() | Lie la source de données au contrôle FormView. (Substitue BaseDataBoundControl.DataBind().) |
|
DataBind(Boolean) | Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.) |
|
DataBindChildren | Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
DeleteItem | Supprime l'enregistrement actif dans le contrôle FormView de la source de données. |
|
Dispose | Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.) |
|
EnsureChildControls | Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.) |
|
EnsureDataBound | S'assure que le contrôle FormView est lié aux données lorsque cela s'avère nécessaire. (Substitue BaseDataBoundControl.EnsureDataBound().) |
|
EnsureID | Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.) |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
ExtractRowValues | Récupère les valeurs de chaque champ déclarées dans la ligne de données spécifiée et les stocke dans l'objet IOrderedDictionary spécifié. |
|
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.) |
|
FindControl(String) | Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control.) |
|
FindControl(String, Int32) | Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control.) |
|
Focus | Affecte le focus d'entrée à un contrôle. (Hérité de Control.) |
|
GetData | Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. (Hérité de DataBoundControl.) |
|
GetDataSource | Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl.) |
|
GetDesignModeState | Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.) |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetRouteUrl(Object) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.) |
|
GetRouteUrl(RouteValueDictionary) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.) |
|
GetRouteUrl(String, Object) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.) |
|
GetRouteUrl(String, RouteValueDictionary) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
GetUniqueIDRelativeTo | Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.) |
|
HasControls | Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.) |
|
HasEvents | Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.) |
|
InitializePager | Crée la ligne de pagineur pour le contrôle FormView. |
|
InitializeRow | Initialise l'objet FormViewRow spécifié. |
|
InsertItem | Insère l'enregistrement actif dans la source de données. |
|
IsBindableType | Détermine si le type de données spécifié peut être lié à un champ dans le contrôle FormView. |
|
IsLiteralContent | Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.) |
|
LoadControlState | Infrastructure. Charge l'état des propriétés du contrôle FormView à faire persister, même lorsque la propriété EnableViewState a la valeur false. (Substitue Control.LoadControlState(Object).) |
|
LoadViewState | Charge l'état d'affichage enregistré précédemment du contrôle FormView. (Substitue WebControl.LoadViewState(Object).) |
|
MapPathSecure | Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control.) |
|
MarkAsDataBound | Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données. (Hérité de DataBoundControl.) |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
MergeStyle | Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ModifiedOuterTableStylePropertyName | Infrastructure. Détermine si les règles de style CSS spécifiques à la table associées au contrôle FormView ont pour valeur leurs valeurs par défaut. |
|
OnBubbleEvent | Gère un événement remonté dans la hiérarchie des contrôles. (Substitue Control.OnBubbleEvent(Object, EventArgs).) |
|
OnDataBinding | Déclenche l'événement DataBinding. (Hérité de Control.) |
|
OnDataBound | Déclenche l'événement DataBound. (Hérité de BaseDataBoundControl.) |
|
OnDataPropertyChanged | Relie le contrôle lié aux données à ses données après la modification d'une des propriétés de l'identification de la source de données de base. (Hérité de DataBoundControl.) |
|
OnDataSourceViewChanged | Déclenche l'événement DataSourceViewChanged. (Hérité de DataBoundControl.) |
|
OnInit | Déclenche l'événement Init. (Substitue BaseDataBoundControl.OnInit(EventArgs).) |
|
OnItemCommand | Déclenche l'événement ItemCommand. |
|
OnItemCreated | Déclenche l'événement ItemCreated. |
|
OnItemDeleted | Déclenche l'événement ItemDeleted. |
|
OnItemDeleting | Déclenche l'événement ItemDeleting. |
|
OnItemInserted | Déclenche l'événement ItemInserted. |
|
OnItemInserting | Déclenche l'événement ItemInserting. |
|
OnItemUpdated | Déclenche l'événement ItemUpdated. |
|
OnItemUpdating | Déclenche l'événement ItemUpdating. |
|
OnLoad | Gère l'événement Control.Load. (Hérité de DataBoundControl.) |
|
OnModeChanged | Déclenche l'événement ModeChanged. |
|
OnModeChanging | Déclenche l'événement ModeChanging. |
|
OnPageIndexChanged | Déclenche l'événement PageIndexChanged. |
|
OnPageIndexChanging | Déclenche l'événement PageIndexChanging. |
|
OnPagePreLoad | Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Hérité de DataBoundControl.) |
|
OnPreRender | Gère l'événement PreRender. (Hérité de BaseDataBoundControl.) |
|
OnUnload | Déclenche l'événement Unload. (Hérité de Control.) |
|
OpenFile | Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.) |
|
PerformDataBinding | Lie la source de données spécifiée au contrôle FormView. (Substitue CompositeDataBoundControl.PerformDataBinding(IEnumerable).) |
|
PerformSelect | Récupère les données de la source de données associée. (Hérité de DataBoundControl.) |
|
PrepareControlHierarchy | Infrastructure. Définit la hiérarchie des contrôles du contrôle FormView. |
|
RaiseBubbleEvent | Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.) |
|
RaisePostBackEvent | Déclenche les événements appropriés pour le contrôle FormView lors de la publication sur le serveur. |
|
RemovedControl | Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.) |
|
Render | Affiche le contrôle FormView sur le client. (Substitue WebControl.Render(HtmlTextWriter).) |
|
RenderBeginTag | Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
RenderChildren | Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.) |
|
RenderContents | Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
RenderControl(HtmlTextWriter) | Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé. (Hérité de Control.) |
|
RenderControl(HtmlTextWriter, ControlAdapter) | Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control.) |
|
RenderEndTag | Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ResolveAdapter | Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.) |
|
ResolveClientUrl | Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.) |
|
ResolveUrl | Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.) |
|
SaveControlState | Infrastructure. Enregistre l'état des propriétés du contrôle FormView à faire persister, même lorsque la propriété Control.EnableViewState a la valeur false. (Substitue Control.SaveControlState().) |
|
SaveViewState | Enregistre l'état d'affichage actuel du contrôle FormView. (Substitue WebControl.SaveViewState().) |
|
SetDesignModeState | Définit les données au moment du design pour un contrôle. (Hérité de Control.) |
|
SetPageIndex | Définit l'index de la page actuellement affichée dans le contrôle FormView. |
|
SetRenderMethodDelegate | Infrastructure. Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control.) |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
TrackViewState | Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées au contrôle FormView. (Substitue WebControl.TrackViewState().) |
|
UpdateItem | Met à jour l'enregistrement en cours dans la source de données. |
|
ValidateDataSource | Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Hérité de DataBoundControl.) |
| Nom | Description | |
|---|---|---|
|
DataBinding | Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.) |
|
DataBound | Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl.) |
|
Disposed | Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control.) |
|
Init | Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control.) |
|
ItemCommand | Se produit lorsqu'un clic est effectué sur un bouton du contrôle FormView. |
|
ItemCreated | Se produit une fois que toutes les lignes sont créées dans un contrôle FormView. |
|
ItemDeleted | Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle FormView, mais après l'opération de suppression. |
|
ItemDeleting | Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle FormView, mais avant l'opération de suppression. |
|
ItemInserted | Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle FormView, mais après l'opération d'insertion. |
|
ItemInserting | Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle FormView, mais avant l'opération d'insertion. |
|
ItemUpdated | Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle FormView, mais après l'opération de mise à jour. |
|
ItemUpdating | Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle FormView, mais avant l'opération de mise à jour. |
|
Load | Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.) |
|
ModeChanged | Se produit lorsque le contrôle FormView bascule entre les modes édition, insertion et lecture seule, mais après le changement de mode. |
|
ModeChanging | Se produit lorsque le contrôle FormView bascule entre les modes édition, insertion et lecture seule, mais avant le changement de mode. |
|
PageIndexChanged | Se produit lorsque la valeur de la propriété PageIndex change après une opération de pagination. |
|
PageIndexChanging | Se produit lorsque la valeur de la propriété PageIndex change avant une opération de pagination. |
|
PreRender | Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.) |
|
Unload | Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.) |
| Nom | Description | |
|---|---|---|
|
EnableDynamicData(Type) | Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.) |
|
EnableDynamicData(Type, Object) | Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.) |
|
EnableDynamicData(Type, IDictionary<String, Object>) | Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.) |
|
EnablePersistedSelection | Rend la sélection persistante dans les contrôles de données qui prennent en charge la sélection et la pagination. (Défini par DynamicDataExtensions.) |
|
FindDataSourceControl | Retourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.) |
|
FindFieldTemplate | Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.) |
|
FindMetaTable | Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.) |
|
GetDefaultValues | Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.) |
|
GetMetaTable | Obtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.) |
|
SetMetaTable(MetaTable) | Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.) |
|
SetMetaTable(MetaTable, IDictionary<String, Object>) | Surchargé. Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.) |
|
SetMetaTable(MetaTable, Object) | Surchargé. Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.) |
|
TryGetMetaTable | Détermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.) |
| Nom | Description | |
|---|---|---|
|
IAttributeAccessor.GetAttribute | Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.) |
|
IAttributeAccessor.SetAttribute | Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.) |
|
IControlBuilderAccessor.ControlBuilder | Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.) |
|
IControlDesignerAccessor.GetDesignModeState | Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.) |
|
IControlDesignerAccessor.SetDesignModeState | Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.) |
|
IControlDesignerAccessor.SetOwnerControl | Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.) |
|
IControlDesignerAccessor.UserData | Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.) |
|
IDataBindingsAccessor.DataBindings | Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.) |
|
IDataBindingsAccessor.HasDataBindings | Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.) |
|
IDataBoundControl.DataKeyNames | Obtient ou définit un tableau qui contient les noms des champs clé primaire des éléments qui sont affichés dans le contrôle FormView. |
|
IDataBoundControl.DataMember | Obtient ou définit le nom de la liste des éléments de données auquel le contrôle FormView se lie lorsque la source de données contient plusieurs listes d'éléments de données. |
|
IDataBoundControl.DataSource | Obtient ou définit l'objet qui contient la liste des données que le contrôle FormView récupère. |
|
IDataBoundControl.DataSourceID | Obtient ou définit l'ID du contrôle de source de données qui contient la liste des éléments de données que le contrôle FormView récupère. |
|
IDataBoundControl.DataSourceObject | Obtient l'objet source de données qui contient la liste des éléments de données que le contrôle FormView récupère. |
|
IDataBoundItemControl.DataKey | Obtient l'objet qui représente la valeur de clés des données de la ligne dans le contrôle FormView. |
|
IDataBoundItemControl.Mode | Obtient le mode actuel du FormView. |
|
IDataItemContainer.DataItemIndex | Pour obtenir une description de ce membre, consultez IDataItemContainer.DataItemIndex. |
|
IDataItemContainer.DisplayIndex | Pour obtenir une description de ce membre, consultez IDataItemContainer.DisplayIndex. |
|
IExpressionsAccessor.Expressions | Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.) |
|
IExpressionsAccessor.HasExpressions | Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.) |
|
IParserAccessor.AddParsedSubObject | Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.) |
|
IPostBackContainer.GetPostBackOptions | Infrastructure. Détermine les options d'événement de publication (postback) du contrôle FormView. |
|
IPostBackEventHandler.RaisePostBackEvent | Infrastructure. Déclenche des événements pour le contrôle FormView lorsqu'il publie vers le serveur. |
Dans cette rubrique :
Introduction
Le contrôle FormView est utilisé pour afficher un enregistrement unique provenant d'une source de données. Il est semblable au contrôle DetailsView, mais il affiche des modèles définis par l'utilisateur à la place des champs de ligne. La création de vos propres modèles offre une plus grande souplesse pour contrôler la manière dont les données sont affichées. Le contrôle FormView prend en charge les fonctionnalités suivantes :
-
Liaison aux contrôles de source de données, tels que SqlDataSource et ObjectDataSource.
-
Fonctionnalités intégrées d'insertion.
-
Fonctionnalités intégrées de mise à jour et de suppression.
-
Fonctionnalités intégrées de pagination.
-
Accès par programme au modèle objet FormView pour définir des propriétés de manière dynamique, gérer les événements, etc.
-
Apparence personnalisable grâce aux modèles, thèmes et styles définis par l'utilisateur.
Modèles
Pour que le contrôle FormView affiche le contenu, vous devez créer des modèles pour les différentes parties du contrôle. La plupart des modèles sont facultatifs ; toutefois, vous devez créer un modèle pour le mode dans lequel le contrôle est configuré. Par exemple, un contrôle FormView qui prend en charge l'insertion d'enregistrements doit disposer d'un modèle d'insertion d'élément défini. Le tableau suivant énumère les différents modèles que vous pouvez créer.
|
Type de modèle |
Description |
|---|---|
|
Définit le contenu pour la ligne de données lorsque le contrôle FormView est en mode édition. Ce modèle contient généralement des contrôles d'entrée et des boutons de commande à l'aide desquels l'utilisateur peut modifier un enregistrement existant. |
|
|
Définit le contenu de la ligne de données vide affichée lorsque le contrôle FormView est lié à une source de données qui ne contient pas d'enregistrements. Ce modèle contient généralement du contenu permettant d'alerter l'utilisateur que la source de données ne contient pas d'enregistrements. |
|
|
Définit le contenu de la ligne de pied de page. Ce modèle contient généralement le contenu supplémentaire que vous souhaitez afficher dans la ligne de pied de page. RemarqueEn guise d'alternative, vous pouvez simplement spécifier le texte à afficher dans la ligne de pied de page en définissant la propriété FooterText. |
|
|
Définit le contenu de la ligne d'en-tête. Ce modèle contient généralement le contenu supplémentaire que vous souhaitez afficher dans la ligne d'en-tête. RemarqueEn guise d'alternative, vous pouvez simplement spécifier le texte à afficher dans la ligne d'en-tête en définissant la propriété HeaderText. |
|
|
Définit le contenu pour la ligne de données lorsque le contrôle FormView est en mode lecture seule. Ce modèle contient généralement du contenu permettant d'afficher les valeurs d'un enregistrement existant. |
|
|
Définit le contenu pour la ligne de données lorsque le contrôle FormView est en mode insertion. Ce modèle contient généralement des contrôles d'entrée et des boutons de commande à l'aide desquels l'utilisateur peut ajouter un enregistrement. |
|
|
Définit le contenu de la ligne de pagineur affichée lorsque la fonctionnalité de pagination est activée (lorsque true est affecté à la propriété AllowPaging). Ce modèle contient généralement des contrôles à l'aide desquels l'utilisateur peut naviguer vers un autre enregistrement. RemarqueLe contrôle FormView dispose d'une interface utilisateur de ligne de pagineur intégrée.Vous devez créer un modèle de pagineur uniquement si vous souhaitez créer votre propre ligne de pagineur personnalisée. |
Pour afficher la valeur d'un champ dans un modèle d'élément, utilisez une expression de liaison de données. Pour plus d'informations sur les expressions de liaison de données, consultez Syntaxe d'expression de liaison de données.
Les contrôles d'entrée dans le modèle de modification d'élément et le modèle d'insertion d'élément peuvent être liés aux champs d'une source de données en utilisant une expression de liaison bidirectionnelle. Cela permet au contrôle FormView d'extraire automatiquement les valeurs du contrôle d'entrée pour une opération de mise à jour ou d'insertion. Les expressions de liaison bidirectionnelles permettent également aux contrôles d'entrée dans un modèle de modification d'élément d'afficher automatiquement les valeurs de champ d'origine. Pour plus d'informations sur les expressions de liaison bidirectionnelles, consultez Liaison à des bases de données.
Liaison de données
Le contrôle FormView peut être lié à un contrôle de source de données (tel que SqlDataSource, ObjectDataSource ou AccessDataSource) ou à toute source de données qui implémente l'interface System.Collections.IEnumerable, telle que System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T> ou autres types de collection. Utilisez l'une des méthodes suivantes pour lier le contrôle FormView au type de source de données approprié :
-
Pour lier à un contrôle de source de données, affectez la propriété DataSourceID du contrôle FormView avec la valeur ID du contrôle de source de données. Le contrôle FormView lie automatiquement au contrôle de source de données spécifié et peut tirer parti des fonctionnalités du contrôle de source de données pour exécuter les fonctionnalités d'insertion, de mise à jour, de suppression et de pagination. Il s'agit de la méthode recommandée de liaison aux données.
-
Pour établir une liaison avec une source de données qui implémente l'interface System.Collections.IEnumerable, affectez par programme la source de données à la propriété DataSource du contrôle FormView, puis appelez la méthode DataBind. Lorsque cette méthode est utilisée, le contrôle FormView ne fournit pas de fonctionnalités intégrées d'insertion, de mise à jour, de suppression et de pagination. Vous devez fournir ces fonctionnalités en utilisant l'événement approprié.
Pour plus d'informations sur la liaison de données, consultez Accès aux données ASP.NET.
Remarque
|
|---|
|
Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client nuisible. Recherchez dans toutes les informations envoyées par un client un script exécutable, des instructions SQL ou d'autre code avant de les afficher dans votre application. Dans la mesure du possible, il est fortement recommandé que les valeurs soient encodées en HTML avant de les afficher dans ce contrôle. ASP.NET fournit une fonctionnalité de validation de demande d'entrée pour bloquer les scripts et le HTML dans les entrées d'utilisateur (user input). Des contrôles serveur de validation sont également fournis pour valider les entrées d'utilisateur (user input). Pour plus d'informations, consultez Introduction to the Validation Controls. |
Opérations de données
Le contrôle FormView fournit plusieurs fonctionnalités intégrées qui permettent à l'utilisateur de mettre à jour, de supprimer, d'insérer et de parcourir les éléments dans le contrôle. Lorsque le contrôle FormView est lié à un contrôle de source de données, le contrôle FormView peut tirer parti des fonctionnalités du contrôle de source de données et fournir les fonctionnalités automatiques de mise à jour, de suppression, d'insertion et de pagination.
Remarque
|
|---|
|
Le contrôle FormView peut fournir la prise en charge des opérations de mise à jour, d'élimination, d'insertion et de pagination avec d'autres types de sources de données ; toutefois, vous devez fournir un gestionnaire d'événements approprié avec l'implémentation pour ces opérations. |
Puisque le contrôle FormView utilise des modèles, il n'offre pas de moyen de générer automatiquement des boutons de commande pour exécuter les opérations de mise à jour, de suppression ou d'insertion. Vous devez inclure manuellement ces boutons de commande dans le modèle approprié. Le contrôle FormView reconnaît certains boutons dont les propriétés CommandName ont des valeurs spécifiques. Le tableau suivant répertorie les boutons de commande que le contrôle FormView reconnaît.
|
Button |
Valeur de CommandName |
Description |
|---|---|---|
|
Cancel |
"Cancel" |
Utilisé dans les opérations de mise à jour et d'insertion pour annuler l'opération et ignorer les valeurs entrées par l'utilisateur. Le contrôle FormView retourne ensuite au mode spécifié par la propriété DefaultMode. |
|
Supprimer |
"Delete" |
Utilisé dans les opérations de suppression pour supprimer l'enregistrement affiché de la source de données. Déclenche les événements ItemDeleting et ItemDeleted. |
|
Modifier |
"Edit" |
Utilisé dans les opérations de mise à jour pour mettre le contrôle FormView en mode édition. Le contenu spécifié dans la propriété EditItemTemplate est affiché pour la ligne de données. |
|
Insert |
"Insert" |
Utilisé dans les opérations d'insertion pour tenter d'insérer un nouvel enregistrement dans la source de données à l'aide des valeurs fournies par l'utilisateur. Déclenche les événements ItemInserting et ItemInserted. |
|
Nouveau |
"New" |
Utilisé dans les opérations d'insertion pour mettre le contrôle FormView en mode insertion. Le contenu spécifié dans la propriété InsertItemTemplate est affiché pour la ligne de données. |
|
Page |
"Page" |
Utilisé dans les opérations de pagination pour représenter un bouton dans la ligne de pagineur qui exécute la pagination. Pour spécifier l'opération de pagination, affectez "Next", "Prev", "First", "Last" à la propriété CommandArgument du bouton ou de l'index de la page vers laquelle naviguer. Déclenche les événements PageIndexChanging et PageIndexChanged. RemarqueCe type de bouton est généralement utilisé uniquement dans le modèle de pagineur. |
|
Update |
"Update" |
Utilisé dans les opérations de mise à jour pour tenter de mettre à jour l'enregistrement affiché dans la source de données avec les valeurs fournies par l'utilisateur. Déclenche les événements ItemUpdating et ItemUpdated. |
Contrairement au bouton Supprimer (qui supprime immédiatement l'enregistrement affiché), lorsqu'un clic est effectué sur le bouton Modifier ou Nouveau, le contrôle FormView passe respectivement en mode édition ou insertion. En mode édition, le contenu de la propriété EditItemTemplate est affiché pour l'élément de données actuel. En général, le modèle de modification d'élément est défini de telle sorte que le bouton Modifier soit remplacé par un bouton Mettre à jour et un bouton Annuler. Les contrôles d'entrée appropriés pour le type de données du champ (tels qu'un contrôle TextBox ou CheckBox) sont également généralement affichés avec la valeur d'un champ à modifier par l'utilisateur. Cliquer sur le bouton Mettre à jour permet de mettre à jour l'enregistrement dans la source de données, alors que cliquer sur le bouton Annuler permet d'abandonner les modifications.
De même, le contenu de la propriété InsertItemTemplate est affiché pour l'élément de données lorsque le contrôle est en mode insertion. Le modèle d'insertion d'élément est généralement défini de sorte que le bouton Nouveau soit remplacé par un bouton Insérer et un bouton Annuler ; les contrôles d'entrée vides sont affichés pour que l'utilisateur entre les valeurs du nouvel enregistrement. Cliquer sur le bouton Insérer permet d'insérer l'enregistrement dans la source de données, alors que cliquer sur le bouton Annuler permet d'abandonner les modifications.
Le contrôle FormView fournit une fonctionnalité de pagination qui permet à l'utilisateur de naviguer vers d'autres enregistrements de la source de données. Lorsqu'il est activé, une ligne de pagineur est affichée dans le contrôle FormView qui contient les contrôles de navigation entre les pages. Pour activer la pagination, attribuez la valeur true à la propriété AllowPaging. Vous pouvez personnaliser la ligne de pagineur en définissant les propriétés des objets contenus dans les propriétés PagerStyle et PagerSettings. Au lieu d'utiliser l'interface utilisateur de ligne de pagineur intégrée, vous pouvez créer votre propre interface utilisateur en utilisant la propriété PagerTemplate.
Personnalisation de l'interface utilisateur
Vous pouvez personnaliser l'apparence du contrôle FormView en définissant les propriétés de style des différentes parties du contrôle. Le tableau suivant énumère les différentes propriétés de style.
|
Propriété de style |
Description |
|---|---|
|
Les paramètres de style de la ligne de données lorsque le contrôle FormView est en mode édition. |
|
|
Les paramètres de style de la ligne de données vide affichée dans le contrôle FormView lorsque la source de données ne contient pas d'enregistrements. |
|
|
Les paramètres de style pour la ligne de pied de page du contrôle FormView. |
|
|
Les paramètres de style pour la ligne d'en-tête du contrôle FormView. |
|
|
Les paramètres de style de la ligne de données lorsque le contrôle FormView est en mode insertion. |
|
|
Les paramètres de style de la ligne de pagineur affichée dans le contrôle FormView lorsque la fonctionnalité de pagination est activée. |
|
|
Les paramètres de style de la ligne de données lorsque le contrôle FormView est en mode lecture seule. |
Événements
Le contrôle FormView fournit plusieurs événements que vous pouvez programmer. Cela vous permet d'exécuter une routine personnalisée lorsqu'un événement se produit. Le tableau suivant répertorie les événements pris en charge par le contrôle FormView.
|
Événement |
Description |
|---|---|
|
Se produit lorsqu'un clic est effectué sur un bouton du contrôle FormView. Cet événement est souvent utilisé pour exécuter une tâche lorsqu'un clic est effectué dans le contrôle. |
|
|
Se produit après que tous les objets FormViewRow ont été créés dans le contrôle FormView. Cet événement est souvent utilisé pour modifier les valeurs d'un enregistrement avant qu'il ne soit affiché. |
|
|
Se produit lorsqu'un clic est effectué sur le bouton Supprimer (bouton dont la propriété CommandName a la valeur "Delete") et après que le contrôle FormView a supprimé l'enregistrement de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l'opération de suppression. |
|
|
Se produit lorsqu'un clic est effectué sur le bouton Supprimer et avant que le contrôle FormView n'ait supprimé l'enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l'opération de suppression. |
|
|
Se produit lorsqu'un clic est effectué sur un bouton Insérer (bouton dont la propriété CommandName a la valeur "Insert") et après que le contrôle FormView insère l'enregistrement. Cet événement est souvent utilisé pour vérifier les résultats de l'opération d'insertion. |
|
|
Se produit lorsqu'un clic est effectué sur un bouton Insérer et avant que le contrôle FormView n'insère l'enregistrement. Cet événement est souvent utilisé pour annuler l'opération d'insertion. |
|
|
Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour (bouton dont la propriété CommandName a la valeur "Update") et après que le contrôle FormView met à jour l'enregistrement. Cet événement est souvent utilisé pour vérifier les résultats de l'opération de mise à jour. |
|
|
Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour et avant que le contrôle FormView ne mette à jour l'enregistrement. Cet événement est souvent utilisé pour annuler l'opération de mise à jour. |
|
|
Se produit après le passage du contrôle FormView d'un mode à un autre (mode édition, insertion ou lecture seule). Cet événement est souvent utilisé pour exécuter une tâche lorsque le contrôle FormView modifie des modes. |
|
|
Se produit avant que le contrôle FormView ne passe d'un mode à un autre (mode édition, insertion ou lecture seule). Cet événement est souvent utilisé pour annuler une modification du mode. |
|
|
Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle FormView a géré l'opération de pagination. Cet événement est couramment utilisé lorsque vous devez exécuter une tâche après que l'utilisateur a navigué vers un enregistrement différent dans le contrôle. |
|
|
Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle FormView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l'opération de pagination. |
Accessibilité
Pour plus d'informations sur la configuration de ce contrôle afin qu'il génère des balises conforment aux standards d'accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et Contrôles et accessibilité ASP.NET.
Application des styles CSS
Le contrôle FormView vous permet de spécifier des règles de style CSS dans la balise. Si vous utilisez des modèles pour personnaliser l'apparence du contrôle FormView, vous pouvez spécifier des styles CSS dans le balisage que vous fournissez dans les modèles. Dans ce cas, aucune table externe supplémentaire n'est requise. Vous pouvez empêcher le rendu de la table en définissant la propriété RenderOuterTable à la valeur false.
Syntaxe déclarative
<asp:FormView
AccessKey="string"
AllowPaging="True|False"
BackColor="color name|#dddddd"
BackImageUrl="uri"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataKeyNames="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DefaultMode="ReadOnly|Edit|Insert"
EmptyDataText="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
FooterText="string"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
HeaderText="string"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
ID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDeleted="ItemDeleted event handler"
OnItemDeleting="ItemDeleting event handler"
OnItemInserted="ItemInserted event handler"
OnItemInserting="ItemInserting event handler"
OnItemUpdated="ItemUpdated event handler"
OnItemUpdating="ItemUpdating event handler"
OnLoad="Load event handler"
OnModeChanged="ModeChanged event handler"
OnModeChanging="ModeChanging event handler"
OnPageIndexChanged="PageIndexChanged event handler"
OnPageIndexChanging="PageIndexChanging event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PageIndex="integer"
PagerSettings-FirstPageImageUrl="uri"
PagerSettings-FirstPageText="string"
PagerSettings-LastPageImageUrl="uri"
PagerSettings-LastPageText="string"
PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
NumericFirstLast"
PagerSettings-NextPageImageUrl="uri"
PagerSettings-NextPageText="string"
PagerSettings-PageButtonCount="integer"
PagerSettings-Position="Bottom|Top|TopAndBottom"
PagerSettings-PreviousPageImageUrl="uri"
PagerSettings-PreviousPageText="string"
PagerSettings-Visible="True|False"
RenderTable="True|False"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
Visible="True|False"
Width="size"
>
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<EditRowStyle />
<EmptyDataRowStyle />
<EmptyDataTemplate>
<!-- child controls -->
</EmptyDataTemplate>
<FooterStyle />
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderStyle />
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<InsertItemTemplate>
<!-- child controls -->
</InsertItemTemplate>
<InsertRowStyle />
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
<PagerSettings
FirstPageImageUrl="uri"
FirstPageText="string"
LastPageImageUrl="uri"
LastPageText="string"
Mode="NextPrevious|Numeric|NextPreviousFirstLast|
NumericFirstLast"
NextPageImageUrl="uri"
NextPageText="string"
OnPropertyChanged="PropertyChanged event handler"
PageButtonCount="integer"
Position="Bottom|Top|TopAndBottom"
PreviousPageImageUrl="uri"
PreviousPageText="string"
Visible="True|False"
/>
<PagerStyle />
<PagerTemplate>
<!-- child controls -->
</PagerTemplate>
<RowStyle />
</asp:FormView>
L'exemple suivant illustre l'utilisation d'un contrôle FormView pour afficher les valeurs provenant d'un contrôle SqlDataSource.
<%@ Page language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormView Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormView Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" runat="server"> <itemtemplate> <table> <tr> <td> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td> <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3> <%# Eval("Title") %> </td> </tr> </table> </itemtemplate> <pagersettings position="Bottom" mode="NextPrevious"/> </asp:formview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:sqldatasource id="EmployeeSource" selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
L'exemple suivant montre comment utiliser un contrôle FormView pour modifier des enregistrements existants.
Note de sécurité
|
|---|
|
Dans cet exemple, le contrôle a une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script. |
<%@ Page language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> void EmployeeFormView_ItemUpdating(Object sender, FormViewUpdateEventArgs e) { // Validate the field values entered by the user. This // example determines whether the user left any fields // empty. Use the NewValues property to access the new // values entered by the user. ArrayList emptyFieldList = ValidateFields(e.NewValues); if (emptyFieldList.Count > 0) { // The user left some fields empty. Display an error message. // Use the Keys property to retrieve the key field value. String keyValue = e.Keys["EmployeeID"].ToString(); MessageLabel.Text = "You must enter a value for each field of record " + keyValue + ".<br/>The following fields are missing:<br/><br/>"; // Display the missing fields. foreach (String value in emptyFieldList) { // Use the OldValues property to access the original value // of a field. MessageLabel.Text += value + " - Original Value = " + e.OldValues[value].ToString() + "<br />"; } // Cancel the update operation. e.Cancel = true; } else { // The field values passed validation. Clear the // error message label. MessageLabel.Text = ""; } } ArrayList ValidateFields(IOrderedDictionary list) { // Create an ArrayList object to store the // names of any empty fields. ArrayList emptyFieldList = new ArrayList(); // Iterate though the field values entered by // the user and check for an empty field. Empty // fields contain a null value. foreach (DictionaryEntry entry in list) { if (entry.Value == String.Empty) { // Add the field name to the ArrayList object. emptyFieldList.Add(entry.Key.ToString()); } } return emptyFieldList; } void EmployeeFormView_ModeChanging(Object sender, FormViewModeEventArgs e) { if (e.CancelingEdit) { // The user canceled the update operation. // Clear the error message label. MessageLabel.Text = ""; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormView Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormView Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" headertext="Employee Record" emptydatatext="No employees found." onitemupdating="EmployeeFormView_ItemUpdating" onmodechanging="EmployeeFormView_ModeChanging" runat="server"> <headerstyle backcolor="CornFlowerBlue" forecolor="White" font-size="14" horizontalalign="Center" wrap="false"/> <rowstyle backcolor="LightBlue" wrap="false"/> <pagerstyle backcolor="CornFlowerBlue"/> <itemtemplate> <table> <tr> <td rowspan="6"> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <%# Eval("FirstName") %> <%# Eval("LastName") %> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <%# Eval("Title") %> </td> </tr> <tr> <td> <b>Hire Date:</b> </td> <td> <%# Eval("HireDate","{0:d}") %> </td> </tr> <tr style="height:150; vertical-align:top"> <td> <b>Address:</b> </td> <td> <%# Eval("Address") %><br/> <%# Eval("City") %> <%# Eval("Region") %> <%# Eval("PostalCode") %><br/> <%# Eval("Country") %> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="Edit" text="Edit" commandname="Edit" runat="server"/> </td> </tr> </table> </itemtemplate> <edititemtemplate> <table> <tr> <td rowspan="6"> <asp:image id="EmployeeEditImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <asp:textbox id="FirstNameUpdateTextBox" text='<%# Bind("FirstName") %>' runat="server"/> <asp:textbox id="LastNameUpdateTextBox" text='<%# Bind("LastName") %>' runat="server"/> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <asp:textbox id="TitleUpdateTextBox" text='<%# Bind("Title") %>' runat="server"/> </td> </tr> <tr> <td> <b>Hire Date:</b> </td> <td> <asp:textbox id="HireDateUpdateTextBox" text='<%# Bind("HireDate", "{0:d}") %>' runat="server"/> </td> </tr> <tr style="height:150; vertical-align:top"> <td> <b>Address:</b> </td> <td> <asp:textbox id="AddressUpdateTextBox" text='<%# Bind("Address") %>' runat="server"/> <br/> <asp:textbox id="CityUpdateTextBox" text='<%# Bind("City") %>' runat="server"/> <asp:textbox id="RegionUpdateTextBox" text='<%# Bind("Region") %>' width="40" runat="server"/> <asp:textbox id="PostalCodeUpdateTextBox" text='<%# Bind("PostalCode") %>' width="60" runat="server"/> <br/> <asp:textbox id="CountryUpdateTextBox" text='<%# Bind("Country") %>' runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="UpdateButton" text="Update" commandname="Update" runat="server"/> <asp:linkbutton id="CancelButton" text="Cancel" commandname="Cancel" runat="server"/> </td> </tr> </table> </edititemtemplate> <pagersettings position="Bottom" mode="Numeric"/> </asp:formview> <br/><br/> <asp:label id="MessageLabel" forecolor="Red" runat="server"/> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:sqldatasource id="EmployeeSource" selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]" updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
L'exemple suivant montre comment utiliser un contrôle FormView pour insérer de nouveaux enregistrements.
Note de sécurité
|
|---|
|
Dans cet exemple, le contrôle a une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script. |
<%@ Page language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormView InsertItemTemplate Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormView InsertItemTemplate Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" emptydatatext="No employees found." runat="server"> <rowstyle backcolor="LightGreen" wrap="false"/> <insertrowstyle backcolor="LightBlue" wrap="false"/> <itemtemplate> <table> <tr> <td rowspan="5"> <asp:image id="CompanyLogoImage" imageurl="~/Images/Logo.jpg" alternatetext="Company logo" runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <%# Eval("FirstName") %> <%# Eval("LastName") %> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <%# Eval("Title") %> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="NewButton" text="New" commandname="New" runat="server"/> </td> </tr> </table> </itemtemplate> <insertitemtemplate> <table> <tr> <td rowspan="4"> <asp:image id="CompanyLogoEditImage" imageurl="~/Images/Logo.jpg" alternatetext="Company logo" runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b><asp:Label runat="server" AssociatedControlID="FirstNameInsertTextBox" Text="Name" />:</b> </td> <td> <asp:textbox id="FirstNameInsertTextBox" text='<%# Bind("FirstName") %>' runat="server"/> <asp:textbox id="LastNameInsertTextBox" text='<%# Bind("LastName") %>' runat="server"/> </td> </tr> <tr> <td> <b><asp:Label runat="server" AssociatedControlID="TitleInsertTextBox" Text="Title" />:</b> </td> <td> <asp:textbox id="TitleInsertTextBox" text='<%# Bind("Title") %>' runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="InsertButton" text="Insert" commandname="Insert" runat="server" /> <asp:linkbutton id="CancelButton" text="Cancel" commandname="Cancel" runat="server" /> </td> </tr> </table> </insertitemtemplate> </asp:formview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:sqldatasource id="EmployeeSource" selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]" insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title]) VALUES (@LastName, @FirstName, @Title)" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Remarque
Note de sécurité