Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
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

DetailsView, classe

.NET Framework 4

Affiche les valeurs d'un enregistrement unique d'une source de données dans un tableau, où chaque ligne de données représente un champ de l'enregistrement. Le contrôle DetailsView vous permet de modifier, de supprimer et d'insérer des enregistrements.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.CompositeDataBoundControl
            System.Web.UI.WebControls.DetailsView

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
[ControlValuePropertyAttribute("SelectedValue")]
public class DetailsView : CompositeDataBoundControl, 
	IDataItemContainer, INamingContainer, ICallbackContainer, ICallbackEventHandler, IPostBackEventHandler, 
	IPostBackContainer, IDataBoundItemControl, IDataBoundControl, IFieldControl
ASP.NET
Copier 
<asp:DetailsView />

Le type DetailsView expose les membres suivants.

  Nom Description
Méthode publique DetailsView Initialise une nouvelle instance de la classe DetailsView.
Début
  Nom Description
Propriété publique 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.)
Propriété protégée Adapter Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publique AllowPaging Obtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée.
Propriété publique AlternatingRowStyle Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence des lignes de données en alternance dans un contrôle DetailsView.
Propriété publique 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.)
Propriété publique 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.)
Propriété publique AutoGenerateDeleteButton Obtient ou définit une valeur indiquant si le contrôle intégré pour supprimer l'enregistrement actuel s'affiche dans un contrôle DetailsView.
Propriété publique AutoGenerateEditButton Obtient ou définit une valeur indiquant si les contrôles intégrés pour modifier l'enregistrement actuel s'affichent dans un contrôle DetailsView.
Propriété publique AutoGenerateInsertButton Obtient ou définit une valeur indiquant si les contrôles intégrés pour insérer un nouvel enregistrement s'affichent dans un contrôle DetailsView.
Propriété publique AutoGenerateRows Obtient ou définit une valeur indiquant si les champs de ligne de chaque champ de la source de données sont automatiquement générés et affichés dans un contrôle DetailsView.
Propriété publique BackColor Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BackImageUrl Obtient ou définit l'URL d'une image à afficher à l'arrière-plan d'un contrôle DetailsView.
Propriété publique BindingContainer Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publique BorderColor Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publique BorderStyle Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BorderWidth Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BottomPagerRow Obtient un objet DetailsViewRow qui représente la ligne du bas de pagineur dans un contrôle DetailsView.
Propriété publique Caption Obtient ou définit le texte à afficher dans un élément de légende HTML d'un contrôle DetailsView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.
Propriété publique CaptionAlign Obtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle DetailsView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.
Propriété publique CellPadding Obtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci.
Propriété publique CellSpacing Obtient ou définit l'espace entre les cellules.
Propriété protégée ChildControlsCreated Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publique ClientID Obtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publique ClientIDMode Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.)
Propriété protégée 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.)
Propriété publique CommandRowStyle Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence d'une ligne de commande dans un contrôle DetailsView.
Propriété protégée Context Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publique Controls Obtient une collection de contrôles enfants dans le contrôle composite lié aux données. (Hérité de CompositeDataBoundControl.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique CurrentMode Obtient le mode d'entrée des données actuel du contrôle DetailsView.
Propriété publique DataItem Obtient l'élément de données lié au contrôle DetailsView.
Propriété publique DataItemContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publique DataItemCount Obtient le nombre d'éléments dans la source de données sous-jacente.
Propriété publique DataItemIndex Obtient l'index de l'élément qui est affiché dans un contrôle DetailsView provenant de la source de données sous-jacente.
Propriété publique DataKey Obtient un objet DataKey qui représente la clé primaire de l'enregistrement affiché.
Propriété publique DataKeyNames Obtient ou définit un tableau qui contient les noms des champs clés pour la source de données.
Propriété publique DataKeysContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique DefaultMode Obtient ou définit le mode d'entrée par défaut du contrôle DetailsView.
Propriété protégée DesignMode Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publique EditRowStyle Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence des lignes de données lorsqu'un contrôle DetailsView est en mode édition.
Propriété publique 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 DetailsView ne contient pas d'enregistrements.
Propriété publique EmptyDataTemplate Obtient ou définit le contenu défini par l'utilisateur de la ligne de données vide rendue lorsqu'un contrôle DetailsView est lié à une source de données qui ne contient pas d'enregistrements.
Propriété publique EmptyDataText Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle DetailsView est lié à une source de données qui ne contient pas d'enregistrements.
Propriété publique Enabled Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publique EnableModelValidation Obtient ou définit une valeur qui indique si la validation de modèle de données est activée.
Propriété publique EnablePagingCallbacks Obtient ou définit une valeur indiquant si les fonctions de rappel côté client sont utilisées pour les opérations de pagination dans le contrôle DetailsView.
Propriété publique EnableTheming Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publique 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.)
Propriété protégée 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.)
Propriété publique FieldHeaderStyle Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la colonne d'en-tête dans un contrôle DetailsView.
Propriété publique Fields Obtient une collection d'objets DataControlField qui représentent les champs de ligne déclarés explicitement dans un contrôle DetailsView.
Propriété publique Font Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publique FooterRow Obtient un objet DetailsViewRow qui représente la ligne de pied de page dans un contrôle DetailsView.
Propriété publique 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 DetailsView.
Propriété publique FooterTemplate Obtient ou définit le contenu défini par l'utilisateur pour la ligne de pied de page dans un contrôle DetailsView.
Propriété publique FooterText Obtient ou définit le texte à afficher dans la ligne de pied de page d'un contrôle DetailsView.
Propriété publique 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.)
Propriété publique GridLines Obtient ou définit le style de quadrillage d'un contrôle DetailsView.
Propriété publique HasAttributes Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégée 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.)
Propriété publique HeaderRow Obtient un objet DetailsViewRow qui représente la ligne d'en-tête dans un contrôle DetailsView.
Propriété publique 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 DetailsView.
Propriété publique HeaderTemplate Obtient ou définit le contenu défini par l'utilisateur pour la ligne d'en-tête dans un contrôle DetailsView.
Propriété publique HeaderText Obtient ou définit le texte à afficher dans la ligne d'en-tête d'un contrôle DetailsView.
Propriété publique Height Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique HorizontalAlign Obtient ou définit l'alignement horizontal d'un contrôle DetailsView sur la page.
Propriété publique ID Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégée IdSeparator Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégée Initialized Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl.)
Propriété publique InsertRowStyle Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence des lignes de données dans un contrôle DetailsView lorsque le contrôle DetailsView est en mode insertion.
Propriété protégée IsBoundUsingDataSourceID Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl.)
Propriété protégée IsChildControlStateCleared Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.)
Propriété protégée IsEnabled Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégée IsTrackingViewState Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégée IsViewStateEnabled Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété protégée 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.)
Propriété publique 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.)
Propriété publique Page Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publique PageCount Obtient le nombre d'enregistrements dans la source de données.
Propriété publique PageIndex Obtient ou définit l'index de l'enregistrement affiché.
Propriété publique 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 DetailsView.
Propriété publique 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 DetailsView.
Propriété publique PagerTemplate Obtient ou définit le contenu personnalisé de la ligne de pagineur dans un contrôle DetailsView.
Propriété publique 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.)
Propriété publique RenderingCompatibility Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété protégée RequiresDataBinding Obtient ou définit une valeur indiquant si la méthode DataBind doit être appelée. (Hérité de BaseDataBoundControl.)
Propriété publique Rows Obtient une collection d'objets DetailsViewRow qui représentent les lignes de données d'un contrôle DetailsView.
Propriété publique RowsGenerator Obtient ou définit un objet qui implémente l'interface IAutoFieldGenerator afin de renseigner automatiquement des lignes dans la vue.
Propriété publique RowStyle Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de lignes de données dans un contrôle DetailsView.
Propriété protégée 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.)
Propriété publique SelectedValue Obtient la valeur de clés des données de l'enregistrement en cours dans un contrôle DetailsView.
Propriété publique 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.)
Propriété publique SkinID Obtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique TabIndex Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégée TagKey Obtient la valeur HtmlTextWriterTag du contrôle DetailsView. (Substitue WebControl.TagKey.)
Propriété protégée 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.)
Propriété publique TemplateControl Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publique TemplateSourceDirectory Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publique 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.)
Propriété publique TopPagerRow Obtient un objet DetailsViewRow qui représente la ligne du haut du pagineur dans un contrôle DetailsView.
Propriété publique UniqueID Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété protégée 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.)
Propriété protégée ViewStateIgnoresCase Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publique ViewStateMode Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publique 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.)
Propriété publique Width Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début
  Nom Description
Méthode protégée 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.)
Méthode protégée AddedControl Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode publique ChangeMode Bascule le contrôle DetailsView vers le mode spécifié.
Méthode protégée ClearCachedClientID Infrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégée ClearChildControlState Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée 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.)
Méthode protégée ClearChildViewState Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée 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.)
Méthode protégée ConfirmInitState Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl.)
Méthode publique 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.)
Méthode protégée CreateAutoGeneratedRow Crée un objet AutoGeneratedField qui représente un champ de ligne généré automatiquement à l'aide des propriétés de champ spécifiées.
Méthode protégée CreateAutoGeneratedRows Crée un ensemble de champs de ligne générés automatiquement pour l'élément de données spécifié.
Méthode protégée 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.)
Méthode protégée CreateChildControls(IEnumerable, Boolean) Crée la hiérarchie des contrôles utilisée pour rendre le contrôle DetailsView. (Substitue CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean).)
Méthode protégée 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.)
Méthode protégée CreateControlStyle Crée un objet de style de table par défaut pour le contrôle DetailsView. (Substitue WebControl.CreateControlStyle().)
Méthode protégée CreateDataSourceSelectArguments Infrastructure. Crée l'objet DataSourceSelectArguments qui passe à la commande Select. (Substitue DataBoundControl.CreateDataSourceSelectArguments().)
Méthode protégée CreateFieldSet Crée l'ensemble complet de champs de ligne générés automatiquement et de champs définis par l'utilisateur utilisés pour générer la hiérarchie des contrôles.
Méthode protégée CreateRow Crée un objet DetailsViewRow à l'aide de l'index de l'élément, du type de ligne et de l'état de ligne spécifiés.
Méthode protégée CreateTable Crée la table conteneur pour le contrôle DetailsView.
Méthode publique DataBind() Infrastructure. Appelle la méthode DataBind de la classe de base. (Substitue BaseDataBoundControl.DataBind().)
Méthode protégée 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.)
Méthode protégée DataBindChildren Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publique DeleteItem Supprime l'enregistrement actuel de la source de données.
Méthode publique 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.)
Méthode protégée 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.)
Méthode protégée EnsureDataBound Infrastructure. Appelle la méthode DataBind après avoir vérifié que le contrôle de liste de données nécessite une liaison de données et qu'un contrôle de source de données valide est spécifié. (Substitue BaseDataBoundControl.EnsureDataBound().)
Méthode protégée EnsureID Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée ExtractRowValues Récupère les valeurs de chaque champ affiché et les stocke dans l'objet IOrderedDictionary spécifié.
Méthode protégée 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.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode publique Focus Affecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégée GetCallbackResult Retourne le résultat d'un événement de rappel qui cible un contrôle.
Méthode protégée GetCallbackScript Infrastructure. Retourne la chaîne de rappel créée à l'aide de l'argument spécifié.
Méthode protégée 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.)
Méthode protégée 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.)
Méthode protégée GetDesignModeState Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetRouteUrl(Object) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(RouteValueDictionary) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique GetUniqueIDRelativeTo Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publique HasControls Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégée HasEvents Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégée InitializePager Crée la ligne de pagineur pour le contrôle DetailsView.
Méthode protégée InitializeRow Initialise l'objet DetailsViewRow spécifié.
Méthode publique InsertItem Insère l'enregistrement actif dans la source de données.
Méthode publique IsBindableType Détermine si le type de données spécifié peut être lié à un champ dans le contrôle DetailsView.
Méthode protégée IsLiteralContent Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégée LoadControlState Charge l'état des propriétés du contrôle DetailsView à faire persister, même lorsque la propriété EnableViewState a la valeur false. (Substitue Control.LoadControlState(Object).)
Méthode protégée LoadViewState Charge l'état d'affichage enregistré précédemment du contrôle DetailsView. (Substitue WebControl.LoadViewState(Object).)
Méthode protégée 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.)
Méthode protégée 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.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique 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.)
Méthode protégée OnBubbleEvent Détermine si l'événement pour les contrôles serveur Web est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Substitue Control.OnBubbleEvent(Object, EventArgs).)
Méthode protégée OnDataBinding Déclenche l'événement DataBinding. (Hérité de Control.)
Méthode protégée OnDataBound Déclenche l'événement DataBound. (Hérité de BaseDataBoundControl.)
Méthode protégée 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.)
Méthode protégée OnDataSourceViewChanged Infrastructure. Déclenche l'événement DataSourceViewChanged. (Substitue DataBoundControl.OnDataSourceViewChanged(Object, EventArgs).)
Méthode protégée OnInit Déclenche l'événement Init. (Substitue BaseDataBoundControl.OnInit(EventArgs).)
Méthode protégée OnItemCommand Déclenche l'événement ItemCommand.
Méthode protégée OnItemCreated Déclenche l'événement ItemCreated.
Méthode protégée OnItemDeleted Déclenche l'événement ItemDeleted.
Méthode protégée OnItemDeleting Déclenche l'événement ItemDeleting.
Méthode protégée OnItemInserted Déclenche l'événement ItemInserted.
Méthode protégée OnItemInserting Déclenche l'événement ItemInserting.
Méthode protégée OnItemUpdated Déclenche l'événement ItemUpdated.
Méthode protégée OnItemUpdating Déclenche l'événement ItemUpdating.
Méthode protégée OnLoad Gère l'événement Control.Load. (Hérité de DataBoundControl.)
Méthode protégée OnModeChanged Déclenche l'événement ModeChanged.
Méthode protégée OnModeChanging Déclenche l'événement ModeChanging.
Méthode protégée OnPageIndexChanged Déclenche l'événement PageIndexChanged.
Méthode protégée OnPageIndexChanging Déclenche l'événement PageIndexChanging.
Méthode protégée OnPagePreLoad Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Substitue DataBoundControl.OnPagePreLoad(Object, EventArgs).)
Méthode protégée OnPreRender Déclenche l'événement PreRender. (Substitue BaseDataBoundControl.OnPreRender(EventArgs).)
Méthode protégée OnUnload Déclenche l'événement Unload. (Hérité de Control.)
Méthode protégée OpenFile Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégée PerformDataBinding Infrastructure. Lie la source de données spécifiée au contrôle DetailsView. (Substitue CompositeDataBoundControl.PerformDataBinding(IEnumerable).)
Méthode protégée PerformSelect Récupère les données de la source de données associée. (Hérité de DataBoundControl.)
Méthode protégée PrepareControlHierarchy Infrastructure. Définit la hiérarchie des contrôles du contrôle DetailsView.
Méthode protégée RaiseBubbleEvent Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégée RaiseCallbackEvent Crée les arguments du gestionnaire de rappel de la méthode GetCallbackEventReference().
Méthode protégée RaisePostBackEvent Déclenche les événements appropriés pour le contrôle DetailsView lors de la publication sur le serveur.
Méthode protégée RemovedControl Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégée Render Infrastructure. Affiche le contrôle DetailsView sur le client à l'aide de l'objet HtmlTextWriter spécifié. (Substitue WebControl.Render(HtmlTextWriter).)
Méthode publique 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.)
Méthode protégée 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.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode protégée ResolveAdapter Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publique ResolveClientUrl Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publique ResolveUrl Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégée SaveControlState Infrastructure. Enregistre l'état des propriétés du contrôle DetailsView à faire persister, même lorsque la propriété Control.EnableViewState a la valeur false. (Substitue Control.SaveControlState().)
Méthode protégée SaveViewState Infrastructure. Enregistre l'état d'affichage actuel du contrôle DetailsView. (Substitue WebControl.SaveViewState().)
Méthode protégée SetDesignModeState Définit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique SetPageIndex Définit l'index de la page actuellement affichée dans le contrôle DetailsView.
Méthode publique 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.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégée TrackViewState Infrastructure. Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées au contrôle DetailsView. (Substitue WebControl.TrackViewState().)
Méthode publique UpdateItem Met à jour l'enregistrement en cours dans la source de données.
Méthode protégée 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.)
Début
  Nom Description
Événement public DataBinding Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement public DataBound Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl.)
Événement public 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.)
Événement public 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.)
Événement public ItemCommand Se produit lorsqu'un clic est effectué sur un bouton du contrôle DetailsView.
Événement public ItemCreated Se produit lorsqu'un enregistrement est créé dans un contrôle DetailsView.
Événement public ItemDeleted Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle DetailsView, mais après l'opération de suppression.
Événement public ItemDeleting Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle DetailsView, mais avant l'opération de suppression.
Événement public ItemInserted Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle DetailsView, mais après l'opération d'insertion.
Événement public ItemInserting Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle DetailsView, mais avant l'opération d'insertion.
Événement public ItemUpdated Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle DetailsView, mais après l'opération de mise à jour.
Événement public ItemUpdating Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle DetailsView, mais avant l'opération de mise à jour.
Événement public Load Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement public ModeChanged Se produit lorsqu'un contrôle DetailsView tente de basculer entre les modes édition, insertion et lecture seule, mais après la mise à jour de la propriété CurrentMode.
Événement public ModeChanging Se produit lorsqu'un contrôle DetailsView tente de basculer entre les modes édition, insertion et lecture seule, mais avant la mise à jour de la propriété CurrentMode.
Événement public PageIndexChanged Se produit lorsque la valeur de la propriété PageIndex change après une opération de pagination.
Événement public PageIndexChanging Se produit lorsque la valeur de la propriété PageIndex change avant une opération de pagination.
Événement public PreRender Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement public Unload Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début
  Nom Description
Méthode d'extension publique EnableDynamicData(Type) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnableDynamicData(Type, Object) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnableDynamicData(Type, IDictionary<String, Object>) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique 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.)
Méthode d'extension publique 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.)
Méthode d'extension publique 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.)
Méthode d'extension publique FindMetaTable Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Méthode d'extension publique GetDefaultValues Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique GetMetaTable Obtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique SetMetaTable(MetaTable) Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique 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.)
Méthode d'extension publique 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.)
Méthode d'extension publique TryGetMetaTable Détermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IAttributeAccessor.GetAttribute Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface explicite Méthode privée IAttributeAccessor.SetAttribute Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface explicite Méthode privée ICallbackContainer.GetCallbackScript Infrastructure. Crée le script de rappel pour le contrôle DetailsView.
Implémentation d'interface explicite Méthode privée ICallbackEventHandler.GetCallbackResult Infrastructure. Voir la méthode GetCallbackResult.
Implémentation d'interface explicite Méthode privée ICallbackEventHandler.RaiseCallbackEvent Infrastructure. Déclenche l'événement de rappel à l'aide des arguments spécifiés.
Implémentation d'interface explicite Propriété privée IControlBuilderAccessor.ControlBuilder Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.GetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetOwnerControl Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IControlDesignerAccessor.UserData Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.DataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.HasDataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBoundControl.DataKeyNames Pour obtenir une description de cette propriété, consultez IDataBoundControl.DataKeyNames.
Implémentation d'interface explicite Propriété privée IDataBoundControl.DataMember Pour obtenir une description de cette propriété, consultez IDataBoundControl.DataMember.
Implémentation d'interface explicite Propriété privée IDataBoundControl.DataSource Pour obtenir une description de cette propriété, consultez IDataBoundControl.DataSource.
Implémentation d'interface explicite Propriété privée IDataBoundControl.DataSourceID Pour obtenir une description de cette propriété, consultez IDataBoundControl.DataSourceID.
Implémentation d'interface explicite Propriété privée IDataBoundControl.DataSourceObject Pour obtenir une description de cette propriété, consultez IDataBoundControl.DataSourceObject.
Implémentation d'interface explicite Propriété privée IDataBoundItemControl.DataKey Pour obtenir une description de cette propriété, consultez IDataBoundItemControl.DataKey.
Implémentation d'interface explicite Propriété privée IDataBoundItemControl.Mode Pour obtenir une description de cette propriété, consultez IDataBoundItemControl.Mode.
Implémentation d'interface explicite Propriété privée IDataItemContainer.DataItemIndex Infrastructure. Pour une description de ce membre, consultez DataItemIndex.
Implémentation d'interface explicite Propriété privée IDataItemContainer.DisplayIndex Infrastructure. Pour une description de ce membre, consultez DisplayIndex.
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.Expressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.HasExpressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IFieldControl.FieldsGenerator Pour obtenir une description de cette propriété, consultez IFieldControl.FieldsGenerator.
Implémentation d'interface explicite Méthode privée IParserAccessor.AddParsedSubObject Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IPostBackContainer.GetPostBackOptions Infrastructure. Pour une description de ce membre, consultez IPostBackContainer.GetPostBackOptions.
Implémentation d'interface explicite Méthode privée IPostBackEventHandler.RaisePostBackEvent Infrastructure. Pour une description de ce membre, consultez IPostBackEventHandler.RaisePostBackEvent.
Début

Dans cette rubrique :

Introduction

Le contrôle DetailsView permet d'afficher un enregistrement unique d'une source de données dans un tableau où chaque champ de l'enregistrement s'affiche dans une ligne du tableau. Il peut être utilisé en association avec un contrôle GridView pour les scénarios maîtres/détails. Le contrôle DetailsView prend en charge les fonctionnalités suivantes :

  • Liaison aux contrôles de source de données, telle que SqlDataSource.

  • 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 DetailsView pour définir des propriétés de manière dynamique, gérer les événements, etc.

  • Apparence personnalisable via des thèmes et des styles.

Champs de ligne

Chaque ligne de données du contrôle DetailsView est créée par la déclaration d'un contrôle de champ. Différents types de champs de ligne déterminent le comportement des lignes dans le contrôle. Les contrôles de champ dérivent de DataControlField. Le tableau suivant affiche les différents types de champs de ligne qui peuvent être utilisés.

Type de champ de colonne

Description

BoundField

Affiche la valeur d'un champ dans une source de données sous la forme de texte.

ButtonField

Affiche un bouton de commande dans le contrôle DetailsView. Cela vous permet d'afficher une ligne avec un contrôle bouton personnalisé, par exemple un bouton Ajouter ou Supprimer.

CheckBoxField

Affiche une case à cocher dans le contrôle DetailsView. Ce type de champ de ligne est couramment utilisé pour afficher les champs avec une valeur Boolean.

CommandField

Affiche des boutons de commande intégrés pour exécuter des opérations de modification, d'insertion ou de suppression dans le contrôle DetailsView.

HyperLinkField

Affiche la valeur d'un champ dans une source de données sous la forme de lien hypertexte. Ce type de champ de ligne vous permet de lier un deuxième champ à l'URL du lien hypertexte.

ImageField

Affiche une image dans le contrôle DetailsView.

TemplateField

Affiche le contenu défini par l'utilisateur pour une ligne dans le contrôle DetailsView en fonction d'un modèle spécifié. Ce type de champ de ligne vous permet de créer un champ de ligne personnalisé.

Par défaut, la propriété AutoGenerateRows a la valeur true, qui crée génère automatiquement un objet de champ de ligne dépendant pour chaque champ d'un type pouvant être lié dans la source de données. Les types valides pouvant être liés sont String, DateTime, Decimal, Guid et l'ensemble des types primitifs. Chaque champ s'affiche ensuite dans une ligne sous la forme de texte, suivant l'ordre d'apparition de chaque champ dans la source de données.

La génération automatique des lignes permet d'afficher rapidement et facilement chaque champ dans l'enregistrement. Toutefois, pour utiliser les fonctions avancées du contrôle DetailsView, vous devez explicitement déclarer les champs de ligne à intégrer dans le contrôle DetailsView. Pour déclarer les champs de ligne, affectez d'abord la valeur false à la propriété AutoGenerateRows. Ensuite, ajoutez les balises d'ouverture et de fermeture <Fields> entre les balises d'ouverture et de fermeture du contrôle DetailsView. Enfin, répertoriez les champs de ligne que vous souhaitez inclure entre les balises d'ouverture et de fermeture <Fields>. Les champs de ligne spécifiés sont ajoutés à la collection Fields dans l'ordre répertorié. La collection Fields vous permet de gérer par programme les champs de ligne du contrôle DetailsView.

Remarque Remarque

Les champs de ligne générés automatiquement ne sont pas ajoutés à la collection Fields.

Remarque Remarque

Les champs de ligne déclarés explicitement peuvent être affichés dans une combinaison de champs de ligne générés automatiquement. Lorsque vous utilisez les deux types de lignes, les champs de ligne déclarés explicitement sont rendus en premier, suivis des champs de ligne générés automatiquement.

Liaison de données

Le contrôle DetailsView peut être lié à un contrôle de source de données (tel que SqlDataSource ou ObjectDataSource) 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 DetailsView 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 DetailsView la valeur ID du contrôle de source de données. Le contrôle DetailsView se lie automatiquement au contrôle de source de données spécifié. 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 DetailsView, puis appelez la méthode DataBind.

Pour plus d'informations sur la liaison de données, consultez Liaison à des bases de données.

Sécurité

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. 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). Pour plus d'informations, consultez Vue d'ensemble des attaques de script. Des contrôles serveur de validation sont également fournis pour valider les entrées d'utilisateur (user input). Pour plus d'informations, consultez Syntaxe des contrôles serveur de validation.

Opérations de données

Le contrôle DetailsView fournit des 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 DetailsView est lié à un contrôle de source de données, le contrôle DetailsView 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 Remarque

Le contrôle DetailsView peut fournir la prise en charge des opérations de mise à jour, de suppression, d'insertion et de pagination avec d'autres types de sources de données ; toutefois, vous devez fournir l'implémentation de ces opérations dans un gestionnaire d'événements approprié. Pour plus d'informations, consultez ItemDeleting, ItemInserting et ItemUpdating.

Le contrôle DetailsView peut ajouter automatiquement un champ de ligne CommandField avec le bouton Modifier, Supprimer ou Nouveau en affectant respectivement la valeur true aux propriétés AutoGenerateEditButton, AutoGenerateDeleteButton ou AutoGenerateInsertButton. Contrairement au bouton Supprimer (qui supprime immédiatement l'enregistrement sélectionné), lorsqu'un clic est effectué sur le bouton Modifier ou Nouveau, le contrôle DetailsView passe respectivement en mode édition ou insertion. En mode édition, le bouton Modifier est remplacé par les boutons Mettre à jour et 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) s'affichent 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, en mode insertion, le bouton Nouveau est 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.

Remarque Remarque

Vous pouvez également définir manuellement les boutons de commande de mise à jour, de suppression et d'insertion boutonne dans un champ de ligne ButtonField, CommandField ou TemplateField. Le contrôle DetailsView reconnaît les boutons dont la propriété CommandName est affectée à "Modifier", "Mettre à jour", "Supprimer", "Nouveau", "Insérer" ou "Annuler" ; toutefois, vous devez fournir la fonctionnalité vous-même. Pour plus d'informations, consultez ItemDeleting, ItemInserting et ItemUpdating.

Le contrôle DetailsView fournit une fonctionnalité de pagination qui permet à l'utilisateur de naviguer vers d'autres enregistrements de la source de données. Lorsqu'ils sont activés, les contrôles de navigation entre les pages s'affichent dans une ligne de pagineur. Pour activer la pagination, attribuez la valeur true à la propriété AllowPaging. La ligne de pagineur peut être personnalisée à l'aide des propriétés PagerStyle et PagerSettings.

Personnalisation de l'interface utilisateur

Vous pouvez personnaliser l'apparence du contrôle DetailsView en définissant les propriétés de style des différentes parties du contrôle. Le tableau suivant répertorie les propriétés de style que vous pouvez définir.

Propriété de style

Description

AlternatingRowStyle

Paramètres de style pour les lignes de données en alternance dans le contrôle DetailsView. Lorsque cette propriété est définie, les lignes de données sont affichées en bandes, en alternance entre les paramètres RowStyle et les paramètres AlternatingRowStyle.

CommandRowStyle

Paramètres de style pour la ligne qui contient les boutons de commande intégrés.

EditRowStyle

Paramètres de style des lignes de données lorsque le contrôle DetailsView est en mode édition.

EmptyDataRowStyle

Paramètres de style de la ligne de données vide affichés dans le contrôle DetailsView lorsque la source de données ne contient pas d'enregistrements.

FooterStyle

Paramètres de style pour la ligne de pied de page.

HeaderStyle

Paramètres de style pour la ligne d'en-tête.

InsertRowStyle

Paramètres de style des lignes de données lorsque le contrôle DetailsView est en mode insertion.

PagerStyle

Paramètres de style pour la ligne de pagineur.

RowStyle

Paramètres de style pour les lignes de données dans le contrôle DetailsView. Lorsque la propriété AlternatingRowStyle est également définie, les lignes de données sont affichées en alternance entre les paramètres RowStyle et les paramètres AlternatingRowStyle.

FieldHeaderStyle

Paramètres de style pour la colonne d'en-tête.

Événements

Le contrôle DetailsView 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 DetailsView. Le contrôle DetailsView hérite également de ces événements de ses classes de base : DataBinding, DataBound, Disposed, Init, LoadPreRender et Render.

Événement

Description

ItemCommand

Se produit lors d'un clic sur le bouton d'un contrôle DetailsView.

ItemCreated

Se produit après que tous les objets DetailsViewRow ont été créés dans le contrôle DetailsView. Cet événement est souvent utilisé pour modifier les valeurs d'un enregistrement avant qu'il ne soit affiché.

ItemDeleted

Se produit lorsqu'un clic est effectué sur le bouton Supprimer et après que le contrôle DetailsView 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.

ItemDeleting

Se produit lorsqu'un clic est effectué sur le bouton Supprimer et avant que le contrôle DetailsView n'ait supprimé l'enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l'opération de suppression.

ItemInserted

Se produit lorsqu'un clic est effectué sur un bouton Insérer et après l'insertion de l'enregistrement par le contrôle DetailsView. Cet événement est souvent utilisé pour vérifier les résultats de l'opération d'insertion.

ItemInserting

Se produit lorsqu'un clic est effectué sur un bouton Insérer et avant que le contrôle DetailsView n'insère l'enregistrement. Cet événement est souvent utilisé pour annuler l'opération d'insertion.

ItemUpdated

Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour et après la mise à jour de la ligne par le contrôle DetailsView. Cet événement est souvent utilisé pour vérifier les résultats de l'opération de mise à jour.

ItemUpdating

Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour et avant que le contrôle DetailsView ne mette à jour l'enregistrement. Cet événement est souvent utilisé pour annuler l'opération de mise à jour.

ModeChanged

Se produit après que le contrôle DetailsView modifie des modes (mode édition, insertion ou lecture seule). Cet événement est souvent utilisé pour exécuter une tâche lorsque le contrôle DetailsView modifie des modes.

ModeChanging

Se produit avant que le contrôle DetailsView ne modifie des modes (mode édition, insertion ou lecture seule). Cet événement est souvent utilisé pour annuler une modification du mode.

PageIndexChanged

Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle DetailsView 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.

PageIndexChanging

Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle DetailsView 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.

Syntaxe déclarative

Copier 
<asp:DetailsView
    AccessKey="string"
    AllowPaging="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateInsertButton="True|False"
    AutoGenerateRows="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"
    EnablePagingCallbacks="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"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <AlternatingRowStyle />
        <CommandRowStyle />
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FieldHeaderStyle />
        <Fields>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Fields>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <InsertRowStyle />
        <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:DetailsView>

L'exemple de code suivant montre comment utiliser un contrôle DetailsView en association avec un contrôle GridView pour un scénario maître/détail simple. Il affiche les détails d'un élément sélectionné dans le contrôle GridView.

C#
VB
Copier 

<%@ 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>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            <asp:GridView ID="GridView1" runat="server" 
              AutoGenerateColumns="False" DataSourceID="Customers"
              DataKeyNames="CustomerID">
              <Columns>
                <asp:CommandField ShowSelectButton="True" />
                <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
                <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              </Columns>
            </asp:GridView>
          </td>
          <td valign="top">
            <asp:DetailsView ID="DetailsView1" runat="server" 
              AutoGenerateRows="True" DataKeyNames="CustomerID"
              DataSourceID="Details" Height="50px" Width="301px">
            </asp:DetailsView>
          </td>
        </tr>
      </table>
      &nbsp;&nbsp;
      <asp:SqlDataSource ID="Details" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
        <SelectParameters>
          <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
            PropertyName="SelectedValue"
            Type="String" />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:SqlDataSource ID="Customers" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
      </asp:SqlDataSource>
    </div>
  </form>
</body>
</html>

L'exemple de code suivant montre comment utiliser le contrôle DetailsView pour ajouter, supprimer et modifier des enregistrements.

C#
VB
Copier 


<%@ 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 CustomerDetail_ItemInserted(object sender, 
    DetailsViewInsertedEventArgs e)
  {
    // Refresh the GridView control after a new record is inserted 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemInserting(object sender, 
    DetailsViewInsertEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.Values.Count; i++)
    {
      if (e.Values[i] != null)
      {
        e.Values[i] = Server.HtmlEncode(e.Values[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemUpdated(object sender, 
    DetailsViewUpdatedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemUpdating(object sender, 
    DetailsViewUpdateEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.NewValues.Count; i++)
    {
      if (e.NewValues[i] != null)
      {
        e.NewValues[i] = Server.HtmlEncode(e.NewValues[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemDeleted(object sender, 
    DetailsViewDeletedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
      DetailsView Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <h3>
      DetailsView Example</h3>
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the customers//s detailed     -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="CustomersView" DataSourceID="Customers" 
            AutoGenerateColumns="False"
            DataKeyNames="CustomerID" runat="server">
            <HeaderStyle BackColor="Blue" ForeColor="White" />
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" 
                HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" 
                HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="CustomerDetail" 
            DataSourceID="Details" AutoGenerateRows="false"
            AutoGenerateInsertButton="true" 
            AutoGenerateEditButton="true" 
            AutoGenerateDeleteButton="true"
            EmptyDataText="No records." 
            DataKeyNames="CustomerID" GridLines="Both" 
            OnItemInserted="CustomerDetail_ItemInserted"
            OnItemInserting="CustomerDetail_ItemInserting" 
            OnItemUpdated="CustomerDetail_ItemUpdated"
            OnItemUpdating="CustomerDetail_ItemUpdating" 
            OnItemDeleted="CustomerDetail_ItemDeleted"
            runat="server">
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <RowStyle BackColor="White" />
            <AlternatingRowStyle BackColor="LightGray" />
            <EditRowStyle BackColor="LightCyan" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="Address" HeaderText="Address" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
              <asp:BoundField DataField="Phone" HeaderText="Phone" />
              <asp:BoundField DataField="Fax" HeaderText="Fax" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                   -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] 
        FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      runat="server" 
      SelectCommand="SELECT * FROM [Customers] 
        WHERE ([CustomerID] = @CustomerID)"
      DeleteCommand="DELETE FROM [Customers] 
        WHERE [CustomerID] = @CustomerID"
      InsertCommand="INSERT INTO [Customers] ([CustomerID], 
        [CompanyName], [ContactName], [ContactTitle], [Address], 
        [City], [Region], [PostalCode], [Country], [Phone], [Fax]) 
        VALUES (@CustomerID, @CompanyName, @ContactName, @ContactTitle, 
        @Address, @City, @Region, @PostalCode, @Country, @Phone, @Fax)"
      UpdateCommand="UPDATE [Customers] SET [CompanyName] = @CompanyName, 
        [ContactName] = @ContactName, [ContactTitle] = @ContactTitle, 
        [Address] = @Address, [City] = @City, [Region] = @Region, 
        [PostalCode] = @PostalCode, [Country] = @Country, 
        [Phone] = @Phone, [Fax] = @Fax 
        WHERE [CustomerID] = @CustomerID">
      <SelectParameters>
        <asp:ControlParameter ControlID="CustomersView" 
          Name="CustomerID" PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
      <DeleteParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
      </DeleteParameters>
      <UpdateParameters>
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
        <asp:Parameter Name="CustomerID" Type="String" />
      </UpdateParameters>
      <InsertParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
      </InsertParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

L'exemple de code suivant montre comment ajouter de manière déclarative des champs de ligne au contrôle DetailsView.

C#
VB
Copier 

<%@ 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>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the store's detailed          -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="GridView1" runat="server" 
            DataSourceID="Customers" AutoGenerateColumns="False" 
            DataKeyNames="CustomerID">
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="DetailsView" runat="server"
            DataSourceID="Details" AutoGenerateRows="false"
            DataKeyNames="CustomerID" >
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
                ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                        -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" runat="server" 
      ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
      <SelectParameters>
        <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
          PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

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.
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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ