DynamicField Classe

Définition

Espace de noms:: System.Web.DynamicData

Assembly:: System.Web.DynamicData.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un champ de données affiché dans un contrôle lié aux données qui utilise ASP.NET fonctionnalités de données dynamiques.

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: Object

DataControlField
DynamicField

Implémente: IFieldFormattingOptions IAttributeAccessor

Exemples

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
Syntaxe déclarative

Présentation

La DynamicField classe est utilisée par les 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 des champs individuels à l’aide d’attributs dans le modèle de données ou à l’aide de la UIHint propriété.

L’objet DynamicField restitue 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 du 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 de chaîne vide (« ») en valeurs Null en définissant la propriété sur ConvertEmptyStringToNulltrue.

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

Nom	Description
DynamicField()	Initialise une nouvelle instance de la classe DynamicField.

Propriétés

Nom	Description
AccessibleHeaderText	Obtient ou définit le `AbbreviatedText` texte qui est rendu en tant que valeur de propriété 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é est appliquée à la DataFormatString valeur de champ lorsque le champ de données est en mode édition.
Column	Obtient l’objet MetaColumn auquel cet DynamicField objet est associé.
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 tous les contrôles de serveur Web contenus par l’objet DataControlField . (Hérité de DataControlField)
ConvertEmptyStringToNull	Obtient ou définit une valeur qui indique si les valeurs de chaîne vide (« ») sont automatiquement converties en valeurs Null lorsque 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 consulté 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 au format HTML avant qu’elles ne soient affichées dans un DynamicField objet.
InsertVisible	Obtient une valeur indiquant si l’objet DataControlField est visible lorsque son contrôle parent lié aux données est en mode d’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 d’un contenu textuel affiché par 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 lorsque 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 rendu. (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 par.
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.
ValidationGroup	Obtient l’objet ValidationGroup auquel cet DynamicField objet est associé.
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un DataControlField objet sur plusieurs requêtes pour 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 rendu. (Hérité de DataControlField)

Méthodes

Nom	Description
CloneField()	Crée une copie en double de l’objet dérivé actuel DataControlField. (Hérité de DataControlField)
ConfigureDynamicControl(DynamicControl)	Fournit un mécanisme permettant de modifier un DynamicControl objet créé par la InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) méthode.
CopyProperties(DataControlField)	Copie les propriétés de l’objet actif DynamicField vers l’objet spécifié DataControlField .
CreateDynamicControl()	Fournit un mécanisme pour les classes qui dérivent de DynamicField la façon dont un DynamicControl objet est créé.
CreateField()	Crée et retourne une nouvelle instance de la DynamicField classe.
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 de table actuelle et ajoute la valeur au dictionnaire spécifié.
GetAttribute(String)	Récupère la valeur d’attribut spécifiée.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la 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 précédemment enregistré de la vue de source de données. (Hérité de DataControlField)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnFieldChanged()	Déclenche l’événement `FieldChanged`. (Hérité de DataControlField)
SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage 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 DataControlField objet. (Hérité de DataControlField)
TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour 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 par un champ prennent en charge les rappels. (Hérité de DataControlField)

Implémentations d’interfaces explicites

Nom	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtient ou définit le schéma associé à cet DataControlField objet. (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 précédemment enregistré du champ de contrôle de données. (Hérité de DataControlField)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
IStateManager.TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)

Méthodes d’extension

Nom	Description
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 à l’aide des options de mise en forme spécifiées.
FormatValue(IFieldFormattingOptions, Object)	Met en forme la valeur de champ spécifiée à l’aide des options de mise en forme spécifiées.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?