Partager via


DynamicField Classe

Définition

Représente un champ de données qui s’affiche dans un contrôle lié aux données qui utilise des fonctionnalités Dynamic Data ASP.NET.

public ref class DynamicField : System::Web::UI::WebControls::DataControlField, System::Web::DynamicData::IFieldFormattingOptions, System::Web::UI::IAttributeAccessor
public class DynamicField : System.Web.UI.WebControls.DataControlField, System.Web.DynamicData.IFieldFormattingOptions, System.Web.UI.IAttributeAccessor
type DynamicField = class
    inherit DataControlField
    interface IAttributeAccessor
    interface IFieldFormattingOptions
Public Class DynamicField
Inherits DataControlField
Implements IAttributeAccessor, IFieldFormattingOptions
Héritage
DynamicField
Implémente

Exemples

Consultez un exemple de code d’exécution de cette fonctionnalité : Exécuter.

L’exemple suivant montre comment utiliser l’objet DynamicField dans un GridView contrôle pour afficher et modifier des valeurs à partir d’une table de base de données.

<%@ 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">
  protected void Page_Init(object sender, EventArgs e)
  {
    DynamicDataManager1.RegisterControl(CustomersGridView);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicField Sample</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
  <form id="form1" runat="server">
    <div>
    
      <h2><%= CustomersDataSource.TableName%> Table</h2>
      
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true" 
        HeaderText="List of validation errors"  />
      <asp:DynamicValidator runat="server" ID="DynamicValidator1"
        ControlToValidate="CustomersGridView" Display="None" />
        
      <asp:GridView ID="CustomersGridView" runat="server"
        AutoGenerateColumns="false"
        AutoGenerateEditButton="true"
        AutoGenerateDeleteButton="true"
        DataSourceID="CustomersDataSource"
        AllowPaging="true"
        AllowSorting="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="CustomerID" />
          <asp:DynamicField DataField="FirstName" />
          <asp:DynamicField DataField="LastName" />
        </Columns>        
      </asp:GridView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="CustomersDataSource" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext"
        EnableUpdate="true"
        EnableDelete="true" >
      </asp:LinqDataSource>
      
    </div>
  </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)    
    DynamicDataManager1.RegisterControl(CustomersGridView)
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicField Sample</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
  <form id="form1" runat="server">
    <div>
    
      <h2><%= CustomersDataSource.TableName%> Table</h2>
      
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true" 
        HeaderText="List of validation errors"  />
      <asp:DynamicValidator runat="server" ID="DynamicValidator1"
        ControlToValidate="CustomersGridView" Display="None" />
        
      <asp:GridView ID="CustomersGridView" runat="server"
        AutoGenerateColumns="false"
        AutoGenerateEditButton="true"
        AutoGenerateDeleteButton="true"
        DataSourceID="CustomersDataSource"
        AllowPaging="true"
        AllowSorting="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="CustomerID" />
          <asp:DynamicField DataField="FirstName" />
          <asp:DynamicField DataField="LastName" />
        </Columns>        
      </asp:GridView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="CustomersDataSource" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext"
        EnableUpdate="true"
        EnableDelete="true" >
      </asp:LinqDataSource>
      
    </div>
  </form>
</body>
</html>

Remarques

Dans cette rubrique :

Introduction

La DynamicField classe est utilisée par des contrôles liés aux données, tels que les GridView contrôles et DetailsView les contrôles, pour afficher une valeur de champ qui utilise ASP.NET fonctionnalités de données dynamiques dans des pages personnalisées.

La DynamicField classe fournit des fonctionnalités qui ressemblent à celle de la BoundField classe. Toutefois, étant donné qu’un DynamicField objet est utilisé dans les applications De données dynamiques, vous pouvez tirer parti des fonctionnalités de données dynamiques suivantes :

  • Rendu automatique du contrôle approprié pour un champ à l’aide de modèles de champ, en fonction du type de données. Les modèles de champ peuvent être modifiés globalement pour l’ensemble de l’application.

  • Fourniture d’une validation de données intégrée basée sur le schéma de base de données. Vous pouvez également ajouter des types de validation en personnalisant le modèle de données.

  • Personnalisation du rendu des données pour les champs individuels à l’aide d’attributs dans le modèle de données ou à l’aide de la UIHint propriété.

L’objet DynamicField affiche chaque champ à l’aide d’un DynamicControl contrôle. Pour spécifier le champ de données à afficher dans un DynamicField objet, définissez la DataField propriété sur le nom du champ. Vous pouvez appliquer une chaîne de mise en forme personnalisée à la valeur de champ en définissant la DataFormatString propriété. Par défaut, la chaîne de mise en forme est appliquée aux valeurs de champ uniquement lorsque le contrôle lié aux données est en mode lecture seule. Pour appliquer la chaîne de mise en forme aux valeurs affichées pendant que le contrôle lié aux données est en mode édition, définissez la ApplyFormatInEditMode propriété truesur . Si une valeur de champ est null, vous pouvez afficher une légende personnalisée en définissant la NullDisplayText propriété. L’objet DynamicField peut également convertir automatiquement les valeurs de champ vides («  ») en valeurs null en définissant la ConvertEmptyStringToNull propriété truesur .

Syntaxe déclarative

<asp:DynamicField
    AccessibleHeaderText="string"
    ApplyFormatInEditMode="true|false"
    ControlStyle-BackColor="color name|#dddddd"
    ControlStyle-BorderColor="color name|#dddddd"
    ControlStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    ControlStyle-BorderWidth="size"
    ControlStyle-CssClass="string"
    ControlStyle-Font-Bold="true|false"
    ControlStyle-Font-Italic="true|false"
    ControlStyle-Font-Names="string"
    ControlStyle-Font-Overline="true|false"
    ControlStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    ControlStyle-Font-Strikeout="true|false"
    ControlStyle-Font-Underline="true|false"
    ControlStyle-ForeColor="color name|#dddddd"
    ControlStyle-Height="size"
    ControlStyle-Width="size"
    ConvertEmptyStringToNull="true|false"
    DataField="string"
    DataFormatString="string"
    FooterStyle-BackColor="color name|#dddddd"
    FooterStyle-BorderColor="color name|#dddddd"
    FooterStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    FooterStyle-BorderWidth="size"
    FooterStyle-CssClass="string"
    FooterStyle-Font-Bold="true|false"
    FooterStyle-Font-Italic="true|false"
    FooterStyle-Font-Names="string"
    FooterStyle-Font-Overline="true|false"
    FooterStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    FooterStyle-Font-Strikeout="true|false"
    FooterStyle-Font-Underline="true|false"
    FooterStyle-ForeColor="color name|#dddddd"
    FooterStyle-Height="size"
    FooterStyle-Width="size"
    FooterStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    FooterStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    FooterStyle-Wrap="true|false"
    HeaderImageUrl="uri"
    HeaderStyle-BackColor="color name|#dddddd"
    HeaderStyle-BorderColor="color name|#dddddd"
    HeaderStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    HeaderStyle-BorderWidth="size"
    HeaderStyle-CssClass="string"
    HeaderStyle-Font-Bold="true|false"
    HeaderStyle-Font-Italic="true|false"
    HeaderStyle-Font-Names="string"
    HeaderStyle-Font-Overline="true|false"
    HeaderStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    HeaderStyle-Font-Strikeout="true|false"
    HeaderStyle-Font-Underline="true|false"
    HeaderStyle-ForeColor="color name|#dddddd"
    HeaderStyle-Height="size"
    HeaderStyle-Width="size"
    HeaderStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    HeaderStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    HeaderStyle-Wrap="true|false"
    HeaderText="string"
    InsertVisible="true|false"
    ItemStyle-BackColor="color name|#dddddd"
    ItemStyle-BorderColor="color name|#dddddd"
    ItemStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    ItemStyle-BorderWidth="size"
    ItemStyle-CssClass="string"
    ItemStyle-Font-Bold="true|false"
    ItemStyle-Font-Italic="true|false"
    ItemStyle-Font-Names="string"
    ItemStyle-Font-Overline="true|false"
    ItemStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    ItemStyle-Font-Strikeout="true|false"
    ItemStyle-Font-Underline="true|false"
    ItemStyle-ForeColor="color name|#dddddd"
    ItemStyle-Height="size"
    ItemStyle-Width="size"
    ItemStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    ItemStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    ItemStyle-Wrap="true|false"
    NullDisplayText="string"
    ReadOnly="true|false"
    ShowHeader="true|false"
    SortExpression="string"
    UIHint="string"
    ValidationGroup="string"
    Visible="true|false"
    />
<asp:DynamicField />

Constructeurs

DynamicField()

Initialise une nouvelle instance de la classe DynamicField.

Propriétés

AccessibleHeaderText

Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles.

(Hérité de DataControlField)
ApplyFormatInEditMode

Obtient ou définit une valeur qui indique si la chaîne mise en forme spécifiée par la propriété DataFormatString est appliquée à la valeur de champ lorsque le champ de données est en mode édition.

Column

Obtient l'objet MetaColumn associé à cet objet DynamicField.

Control

Obtient une référence au contrôle de données auquel l'objet DataControlField est associé.

(Hérité de DataControlField)
ControlStyle

Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField.

(Hérité de DataControlField)
ConvertEmptyStringToNull

Obtient ou définit une valeur qui indique si les chaînes vides ("") sont converties automatiquement en valeurs null quand le champ de données est mis à jour dans la source de données.

DataField

Obtient ou définit le nom du champ de données auquel lier l'objet DynamicField.

DataFormatString

Obtient ou définit la chaîne qui spécifie le format d'affichage de la valeur du champ de données.

DesignMode

Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.

(Hérité de DataControlField)
FooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.

(Hérité de DataControlField)
FooterText

Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderImageUrl

Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.

(Hérité de DataControlField)
HeaderText

Obtient ou définit le texte affiché dans l'en-tête du contrôle lié aux données qui contient l'objet DynamicField.

HtmlEncode

Obtient ou définit une valeur qui indique si les valeurs de champ de données sont encodées en HTML avant qu'elles soient affichées dans un objet DynamicField.

InsertVisible

Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion.

(Hérité de DataControlField)
IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
ItemStyle

Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données.

(Hérité de DataControlField)
NullDisplayText

Obtient ou définit la légende affichée pour un champ de données quand la valeur du champ est null.

ReadOnly

Obtient l'état en lecture seule du champ dynamique.

ShowHeader

Obtient ou définit une valeur indiquant si l'élément d'en-tête d'un champ de contrôle de données est restitué.

(Hérité de DataControlField)
SortExpression

Obtient ou définit l'expression de tri utilisée lorsque le champ de données est utilisé pour trier la source de données.

UIHint

Obtient ou définit le modèle de champ à utiliser pour afficher le champ de données.

ValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.

ValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.

(Hérité de DataControlField)
ValidationGroup

Obtient l'objet ValidationGroup associé à cet objet DynamicField.

ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page.

(Hérité de DataControlField)
Visible

Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué.

(Hérité de DataControlField)

Méthodes

CloneField()

Crée une copie de l'objet dérivé de DataControlField en cours.

(Hérité de DataControlField)
ConfigureDynamicControl(DynamicControl)

Fournit un mécanisme de modification d'un objet DynamicControl qui a été créé par la méthode InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).

CopyProperties(DataControlField)

Copie les propriétés de l'objet DynamicField actuel vers l'objet DataControlField spécifié.

CreateDynamicControl()

Fournit un mécanisme pour les classes qui dérivent de DynamicField qui remplace la façon dont un objet DynamicControl est créé.

CreateField()

Crée et retourne une instance de la classe DynamicField.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrait la valeur du champ de données de la cellule active du tableau et ajoute la valeur au dictionnaire spécifié.

GetAttribute(String)

Extrait la valeur d'attribut spécifiée.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
Initialize(Boolean, Control)

Effectue l'initialisation d'instance de base pour un champ de contrôle de données.

(Hérité de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Ajoute du texte ou des contrôles à la cellule spécifiée.

LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.

(Hérité de DataControlField)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnFieldChanged()

Déclenche l’événement FieldChanged.

(Hérité de DataControlField)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
SetAttribute(String, String)

Définit un attribut associé à l'objet DynamicField.

ToString()

Retourne une chaîne qui représente cet objet DataControlField.

(Hérité de DataControlField)
TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)
ValidateSupportsCallback()

En cas de substitution dans une classe dérivée, signale que les contrôles contenus dans un champ prennent en charge des rappels.

(Hérité de DataControlField)

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtient ou définit le schéma associé à cet objet DataControlField.

(Hérité de DataControlField)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données.

(Hérité de DataControlField)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
IStateManager.TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)

Méthodes d’extension

ConvertEditedValue(IFieldFormattingOptions, String)

Retourne la valeur fournie par un utilisateur pour un contrôle en cours de validation.

FormatEditValue(IFieldFormattingOptions, Object)

Met en forme la valeur de champ spécifiée en utilisant les options de mise en forme spécifiées.

FormatValue(IFieldFormattingOptions, Object)

Met en forme la valeur de champ spécifiée en utilisant les options de mise en forme spécifiées.

S’applique à

Voir aussi