DynamicField Osztály

Definíció

Névtér:: System.Web.DynamicData

Szerelvény:: System.Web.DynamicData.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Olyan adatmezőt jelöl, amely egy ASP.NET dinamikus adatfunkciót használó, adathoz kötött vezérlőelemben jelenik meg.

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

Öröklődés: Object

DataControlField
DynamicField

Megvalósítás: IFieldFormattingOptions IAttributeAccessor

Példák

Az alábbi példa bemutatja, hogyan jeleníthet DynamicField meg és szerkeszthet értékeket egy adatbázistábla objektumában GridView .

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

Megjegyzések

Ebben a témakörben:

Bevezetés
Deklaratív szintaxis

Bevezetés

A DynamicField osztályt adathoz kötött vezérlők, például a GridView és a DetailsView vezérlők használják egy olyan mezőérték megjelenítésére, amely ASP.NET dinamikus adatfunkciókat használ az egyéni lapokban.

Az DynamicField osztály az osztályhoz hasonló BoundField funkciókat biztosít. Mivel azonban egy DynamicField objektumot dinamikus adatalkalmazásokban használnak, a következő dinamikus adatfunkciók használhatók:

A mezők megfelelő vezérlőjének automatikus renderelése mezősablonok használatával, az adattípus alapján. A mezősablonok globálisan módosíthatók a teljes alkalmazáshoz.
Beépített adatérvényesítés biztosítása az adatbázisséma alapján. Az adatmodell testreszabásával érvényesítési típusokat is hozzáadhat.
Az egyes mezők adatmegjelenítésének testreszabása az adatmodell attribútumainak használatával vagy a UIHint tulajdonság használatával.

Az DynamicField objektum egy vezérlőelem használatával jeleníti meg az egyes mezőket DynamicControl . Ha meg szeretné adni az objektumban megjelenítendő adatmezőt DynamicField , állítsa a DataField tulajdonságot a mezőnévre. A tulajdonság beállításával egyéni formázási sztringet alkalmazhat a DataFormatString mezőértékre. Alapértelmezés szerint a formázási sztring csak akkor lesz alkalmazva a mezőértékekre, ha az adatkötött vezérlőelem írásvédett módban van. Ha a formázási sztringet a szerkesztési módban megjelenő értékekre szeretné alkalmazni, állítsa a tulajdonságot a ApplyFormatInEditMode következőre true: . Ha egy mező értéke, nulla tulajdonság beállításával NullDisplayText megjeleníthet egy egyéni feliratot. Az DynamicField objektum automatikusan null értékké is konvertálhatja az üres sztring ("") mezőértékeket a ConvertEmptyStringToNull tulajdonság truebeállításával.

Deklaratív szintaxis

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

Konstruktorok

Név	Description
DynamicField()	Inicializálja a DynamicField osztály új példányát.

Tulajdonságok

Név	Description
AccessibleHeaderText	Lekéri vagy beállítja bizonyos vezérlők tulajdonságértékeként `AbbreviatedText` megjelenített szöveget. (Öröklődés forrása DataControlField)
ApplyFormatInEditMode	Lekéri vagy beállít egy értéket, amely jelzi, hogy a tulajdonság által DataFormatString megadott formázott sztring a mező értékére lesz-e alkalmazva, ha az adatmező szerkesztési módban van.
Column	Lekéri az MetaColumn objektumhoz társított objektumot DynamicField .
Control	Az objektumhoz társított adatvezérlőre DataControlField mutató hivatkozást kap. (Öröklődés forrása DataControlField)
ControlStyle	Lekéri az objektum által tartalmazott webkiszolgáló-vezérlők stílusát DataControlField . (Öröklődés forrása DataControlField)
ConvertEmptyStringToNull	Lekéri vagy beállít egy értéket, amely jelzi, hogy az üres sztringértékek ("") automatikusan null értékké lesznek-e konvertálva, amikor az adatmező frissül az adatforrásban.
DataField	Lekéri vagy beállítja az adatmező nevét az objektum kötéséhez DynamicField .
DataFormatString	Lekéri vagy beállítja az adatmező értékének megjelenítési formátumát meghatározó sztringet.
DesignMode	Beolvas egy értéket, amely jelzi, hogy egy adatvezérlő mező jelenleg tervezőkörnyezetben van-e megtekintve. (Öröklődés forrása DataControlField)
FooterStyle	Lekéri vagy beállítja az adatvezérlő mező láblécének stílusát. (Öröklődés forrása DataControlField)
FooterText	Lekéri vagy beállítja az adatvezérlő mező láblécelemében megjelenő szöveget. (Öröklődés forrása DataControlField)
HeaderImageUrl	Lekéri vagy beállítja egy kép URL-címét, amely egy adatvezérlő mező fejlécelemében jelenik meg. (Öröklődés forrása DataControlField)
HeaderStyle	Lekéri vagy beállítja az adatvezérlő mező fejlécének stílusát. (Öröklődés forrása DataControlField)
HeaderText	Lekéri vagy beállítja az objektumot tartalmazó DynamicField adatkötött vezérlőelem fejlécében megjelenő szöveget.
HtmlEncode	Lekéri vagy beállít egy értéket, amely jelzi, hogy az adatmező értékei HTML-kódolással vannak-e kódolva, mielőtt megjelenítenék őket egy DynamicField objektumban.
InsertVisible	Beolvas egy értéket, amely jelzi, hogy az DataControlField objektum látható-e, ha a szülő adatkötésű vezérlőelem beszúrási módban van. (Öröklődés forrása DataControlField)
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az DataControlField objektum menti-e a nézetállapot módosításait. (Öröklődés forrása DataControlField)
ItemStyle	Lekéri az adatvezérlő mező által megjelenített szövegalapú tartalom stílusát. (Öröklődés forrása DataControlField)
NullDisplayText	Lekéri vagy beállítja az adatmezők feliratát, ha a mező értéke .`null`
ReadOnly	Lekéri a dinamikus mező írásvédett állapotát.
ShowHeader	Lekéri vagy beállít egy értéket, amely jelzi, hogy egy adatvezérlő mező fejléceleme renderelve van-e. (Öröklődés forrása DataControlField)
SortExpression	Lekéri vagy beállítja azt a rendezési kifejezést, amely akkor használatos, amikor az adatmezővel rendezi az adatforrást.
UIHint	Lekéri vagy beállítja az adatmező megjelenítéséhez használni kívánt mezősablont.
ValidateRequestMode	Lekéri vagy beállít egy értéket, amely meghatározza, hogy a vezérlő ellenőrzi-e az ügyfélbemenetet.
ValidationGroup	Lekéri az ValidationGroup objektumhoz társított objektumot DynamicField .
ViewState	Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy objektum nézetállapotának mentését és visszaállítását DataControlField ugyanazon lap több kérésében. (Öröklődés forrása DataControlField)
Visible	Lekéri vagy beállít egy értéket, amely jelzi, hogy egy adatvezérlő mező renderelve van-e. (Öröklődés forrása DataControlField)

Metódusok

Név	Description
CloneField()	Másolatot készít az aktuális DataControlFieldszármaztatott objektumról. (Öröklődés forrása DataControlField)
ConfigureDynamicControl(DynamicControl)	A metódus által DynamicControl létrehozott objektumok módosítására InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) szolgáló mechanizmust biztosít.
CopyProperties(DataControlField)	Másolja az aktuális DynamicField objektum tulajdonságait a megadott DataControlField objektumba.
CreateDynamicControl()	Olyan mechanizmust biztosít az osztályok számára, amelyek az objektumok létrehozásának felülbírálására DynamicField DynamicControl szolgálnak.
CreateField()	Létrehozza és visszaadja az osztály új példányát DynamicField .
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Kinyeri az adatmező értékét az aktuális táblázatcellából, és hozzáadja az értéket a megadott szótárhoz.
GetAttribute(String)	Lekéri a megadott attribútumértéket.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Initialize(Boolean, Control)	Alapszintű példány inicializálását hajtja végre egy adatvezérlő mezőhöz. (Öröklődés forrása DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Szöveget vagy vezérlőelemeket ad hozzá a megadott cellához.
LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása DataControlField)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnFieldChanged()	Az eseményt emeli `FieldChanged` ki. (Öröklődés forrása DataControlField)
SaveViewState()	Menti a DataControlField nézetállapot módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása DataControlField)
SetAttribute(String, String)	Beállít egy, az DynamicField objektumhoz társított attribútumot.
ToString()	Az objektumot jelképező DataControlField sztringet ad vissza. (Öröklődés forrása DataControlField)
TrackViewState()	Ez azt eredményezi, hogy az DataControlField objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState tulajdonságában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása DataControlField)
ValidateSupportsCallback()	Ha egy származtatott osztály felül van bírálva, azt jelzi, hogy a mező által tartalmazott vezérlők támogatják a visszahívásokat. (Öröklődés forrása DataControlField)

Explicit interfész-implementációk

Név	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Lekéri vagy beállítja az objektumhoz DataControlField társított sémát. (Öröklődés forrása DataControlField)
IStateManager.IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az DataControlField objektum menti-e a nézetállapot módosításait. (Öröklődés forrása DataControlField)
IStateManager.LoadViewState(Object)	Visszaállítja az adatvezérlő mező korábban mentett nézetállapotát. (Öröklődés forrása DataControlField)
IStateManager.SaveViewState()	Menti a DataControlField nézetállapot módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása DataControlField)
IStateManager.TrackViewState()	Ez azt eredményezi, hogy az DataControlField objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState tulajdonságában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása DataControlField)

Bővítő metódusok

Név	Description
ConvertEditedValue(IFieldFormattingOptions, String)	A felhasználó által az ellenőrzött vezérlőelemhez megadott értéket adja vissza.
FormatEditValue(IFieldFormattingOptions, Object)	Formázhatja a megadott mezőértéket a megadott formázási beállítások használatával.
FormatValue(IFieldFormattingOptions, Object)	Formázhatja a megadott mezőértéket a megadott formázási beállítások használatával.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?