DynamicField Klas

Definitie

Naamruimte:: System.Web.DynamicData

Assembly:: System.Web.DynamicData.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een gegevensveld dat wordt weergegeven in een gegevensgebonden besturingselement dat gebruikmaakt van ASP.NET functies voor dynamische gegevens.

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

Overname: Object

DataControlField
DynamicField

Implementeringen: IFieldFormattingOptions IAttributeAccessor

Voorbeelden

In het volgende voorbeeld ziet u hoe u het DynamicField object in een GridView besturingselement gebruikt om waarden uit een databasetabel weer te geven en te bewerken.

<%@ 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>

Opmerkingen

In dit onderwerp:

Introduction
Declaratieve syntaxis

Introduction

De klasse DynamicField wordt gebruikt door gegevensgebonden besturingselementen, zoals de besturingselementen GridView en DetailsView, om een veldwaarde weer te geven die gebruikmaakt van ASP.NET functies voor dynamische gegevens op aangepaste pagina's.

De DynamicField klasse biedt functionaliteit die lijkt op die van de BoundField klasse. Omdat een DynamicField object echter wordt gebruikt in dynamische gegevenstoepassingen, kunt u profiteren van de volgende functies voor dynamische gegevens:

Automatisch het juiste besturingselement voor een veld weergeven met behulp van veldsjablonen op basis van het gegevenstype. De veldsjablonen kunnen globaal worden gewijzigd voor de hele toepassing.
Ingebouwde gegevensvalidatie bieden op basis van het databaseschema. U kunt ook validatietypen toevoegen door het gegevensmodel aan te passen.
Het aanpassen van gegevensweergave voor afzonderlijke velden met behulp van kenmerken in het gegevensmodel of met behulp van de UIHint eigenschap.

Het DynamicField object geeft elk veld weer met behulp van een DynamicControl besturingselement. Als u het gegevensveld wilt opgeven dat in een DynamicField object moet worden weergegeven, stelt u de DataField eigenschap in op de veldnaam. U kunt een aangepaste opmaaktekenreeks toepassen op de veldwaarde door de DataFormatString eigenschap in te stellen. Standaard wordt de opmaaktekenreeks alleen toegepast op veldwaarden wanneer het gegevensgebonden besturingselement zich in de modus Alleen-lezen bevindt. Als u de opmaaktekenreeks wilt toepassen op waarden die worden weergegeven terwijl het gegevensgebonden besturingselement zich in de bewerkingsmodus bevindt, stelt u de ApplyFormatInEditMode eigenschap in op true. Als een veldwaarde is null, kunt u een aangepast bijschrift weergeven door de NullDisplayText eigenschap in te stellen. Het DynamicField object kan ook automatisch lege tekenreekswaarden ("") converteren naar null-waarden door de ConvertEmptyStringToNull eigenschap in te stellen op true.

Declaratieve syntaxis

<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 />

Constructors

Name	Description
DynamicField()	Initialiseert een nieuw exemplaar van de DynamicField klasse.

Eigenschappen

Name	Description
AccessibleHeaderText	Hiermee wordt tekst opgehaald of ingesteld die wordt weergegeven als de `AbbreviatedText` eigenschapswaarde in sommige besturingselementen. (Overgenomen van DataControlField)
ApplyFormatInEditMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de opgemaakte tekenreeks die door de DataFormatString eigenschap is opgegeven, wordt toegepast op veldwaarde wanneer het gegevensveld zich in de bewerkingsmodus bevindt.
Column	Hiermee haalt u het MetaColumn object op waaraan dit DynamicField object is gekoppeld.
Control	Hiermee haalt u een verwijzing op naar het gegevensbeheer waaraan het DataControlField object is gekoppeld. (Overgenomen van DataControlField)
ControlStyle	Hiermee haalt u de stijl op van webserverbesturingselementen die zijn opgenomen in het DataControlField object. (Overgenomen van DataControlField)
ConvertEmptyStringToNull	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of lege tekenreekswaarden ("") automatisch worden geconverteerd naar null-waarden wanneer het gegevensveld wordt bijgewerkt in de gegevensbron.
DataField	Hiermee wordt de naam van het gegevensveld opgehaald of ingesteld om het DynamicField object aan te binden.
DataFormatString	Hiermee wordt de tekenreeks opgehaald of ingesteld waarmee de weergave-indeling voor de waarde van het gegevensveld wordt opgegeven.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een gegevensbeheerveld momenteel wordt weergegeven in een ontwerpomgeving. (Overgenomen van DataControlField)
FooterStyle	Hiermee haalt u de stijl van de voettekst van het gegevensbeheerveld op of stelt u deze in. (Overgenomen van DataControlField)
FooterText	Hiermee haalt u de tekst op die wordt weergegeven in het voettekstitem van een gegevensbeheerveld of stelt u deze in. (Overgenomen van DataControlField)
HeaderImageUrl	Hiermee wordt de URL opgehaald of ingesteld van een afbeelding die wordt weergegeven in het koptekstitem van een gegevensbeheerveld. (Overgenomen van DataControlField)
HeaderStyle	Hiermee haalt u de stijl van de koptekst van het gegevensbeheerveld op of stelt u deze in. (Overgenomen van DataControlField)
HeaderText	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven in de koptekst van het gegevensgebonden besturingselement dat het DynamicField object bevat.
HtmlEncode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of gegevensveldwaarden HTML-gecodeerd zijn voordat ze in een DynamicField object worden weergegeven.
InsertVisible	Hiermee wordt een waarde opgehaald die aangeeft of het object zichtbaar is wanneer het DataControlField bovenliggende besturingselement voor gegevens in de invoegmodus staat. (Overgenomen van DataControlField)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het DataControlField object wijzigingen opslaat in de weergavestatus. (Overgenomen van DataControlField)
ItemStyle	Hiermee haalt u de stijl op van tekstgebaseerde inhoud die wordt weergegeven door een gegevensbesturingselementveld. (Overgenomen van DataControlField)
NullDisplayText	Hiermee wordt het bijschrift opgehaald of ingesteld dat wordt weergegeven voor een gegevensveld wanneer de veldwaarde is `null`.
ReadOnly	Hiermee wordt de status Alleen-lezen van het dynamische veld opgehaald.
ShowHeader	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het headeritem van een gegevensbeheerveld wordt weergegeven. (Overgenomen van DataControlField)
SortExpression	Hiermee haalt u de sorteerexpressie op die wordt gebruikt wanneer het gegevensveld wordt gebruikt om de gegevensbron te sorteren.
UIHint	Hiermee haalt u de veldsjabloon op die moet worden gebruikt voor het weergeven van het gegevensveld.
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer valideert.
ValidationGroup	Hiermee haalt u het ValidationGroup object op waaraan dit DynamicField object is gekoppeld.
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een DataControlField object kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van DataControlField)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een gegevensbeheerveld wordt weergegeven. (Overgenomen van DataControlField)

Methoden

Name	Description
CloneField()	Hiermee maakt u een dubbele kopie van het huidige DataControlField-afgeleide object. (Overgenomen van DataControlField)
ConfigureDynamicControl(DynamicControl)	Biedt een mechanisme voor het wijzigen van een DynamicControl object dat door de InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) methode is gemaakt.
CopyProperties(DataControlField)	Kopieert de eigenschappen van het huidige DynamicField object naar het opgegeven DataControlField object.
CreateDynamicControl()	Biedt een mechanisme voor klassen die zijn afgeleid van DynamicField het overschrijven van hoe een DynamicControl object wordt gemaakt.
CreateField()	Hiermee maakt en retourneert u een nieuw exemplaar van de DynamicField klasse.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extraheert de waarde van het gegevensveld uit de huidige tabelcel en voegt de waarde toe aan de opgegeven woordenlijst.
GetAttribute(String)	Haalt de opgegeven kenmerkwaarde op.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Initialize(Boolean, Control)	Voert de initialisatie van het basisexemplaren uit voor een gegevensbeheerveld. (Overgenomen van DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Hiermee voegt u tekst of besturingselementen toe aan de opgegeven cel.
LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van DataControlField)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnFieldChanged()	Hiermee wordt de `FieldChanged` gebeurtenis gegenereerd. (Overgenomen van DataControlField)
SaveViewState()	Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in de DataControlField weergavestatus sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van DataControlField)
SetAttribute(String, String)	Hiermee stelt u een kenmerk in dat aan het DynamicField object is gekoppeld.
ToString()	Retourneert een tekenreeks die dit DataControlField object vertegenwoordigt. (Overgenomen van DataControlField)
TrackViewState()	Hiermee zorgt u ervoor dat het DataControlField object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het besturingselement en kunnen worden opgeslagen in aanvragen voor dezelfde pagina. (Overgenomen van DataControlField)
ValidateSupportsCallback()	Wanneer deze worden overschreven in een afgeleide klasse, wordt aangegeven dat de besturingselementen die zijn opgenomen in een veldondersteuning callbacks. (Overgenomen van DataControlField)

Expliciete interface-implementaties

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Hiermee wordt het schema opgehaald of ingesteld dat aan dit DataControlField object is gekoppeld. (Overgenomen van DataControlField)
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het DataControlField object wijzigingen opslaat in de weergavestatus. (Overgenomen van DataControlField)
IStateManager.LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van het gegevensbeheerveld. (Overgenomen van DataControlField)
IStateManager.SaveViewState()	Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in de DataControlField weergavestatus sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van DataControlField)
IStateManager.TrackViewState()	Hiermee zorgt u ervoor dat het DataControlField object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het besturingselement en kunnen worden opgeslagen in aanvragen voor dezelfde pagina. (Overgenomen van DataControlField)

Extensiemethoden

Name	Description
ConvertEditedValue(IFieldFormattingOptions, String)	Retourneert de waarde van een gebruiker voor een besturingselement dat wordt gevalideerd.
FormatEditValue(IFieldFormattingOptions, Object)	Hiermee wordt de opgegeven veldwaarde opgemaakt met behulp van de opgegeven opmaakopties.
FormatValue(IFieldFormattingOptions, Object)	Hiermee wordt de opgegeven veldwaarde opgemaakt met behulp van de opgegeven opmaakopties.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?