DynamicField Třída

Reference

Definice

Obor názvů:: System.Web.DynamicData

Sestavení:: System.Web.DynamicData.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje datové pole, které se zobrazuje v ovládacím prvku vázaném na data, které používá ASP.NET funkce dynamických dat.

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

Dědičnost: Object

DataControlField
DynamicField

Implementuje: IFieldFormattingOptions IAttributeAccessor

Příklady

Podívejte se na příklad kódu za běhu této funkce: Spustit.

Následující příklad ukazuje, jak použít DynamicField objekt v ovládacím GridView prvku k zobrazení a úpravě hodnot z databázové tabulky.

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

Poznámky

V tomto tématu:

Úvod
Deklarativní syntaxe

Úvod

Třída DynamicField je používána ovládacími prvky vázanými na data, jako jsou ovládací GridView prvky a DetailsView ovládací prvky, k zobrazení hodnoty pole, která používá ASP.NET funkce dynamická data na vlastních stránkách.

Třída DynamicField poskytuje funkce, které se podobají BoundField této třídě. Vzhledem k tomu, že DynamicField se objekt používá v aplikacích s dynamickými daty, můžete využít následující funkce dynamických dat:

Automatické vykreslení správného ovládacího prvku pro pole pomocí šablon polí na základě datového typu Šablony polí lze globálně upravit pro celou aplikaci.
Poskytuje integrované ověřování dat na základě schématu databáze. Typy ověřování můžete přidat také přizpůsobením datového modelu.
Přizpůsobení vykreslování dat pro jednotlivá pole pomocí atributů v datovém modelu nebo pomocí UIHint vlastnosti.

Objekt DynamicField vykreslí každé pole pomocí DynamicControl ovládacího prvku. Chcete-li zadat datové pole, které se má zobrazit v objektu DynamicField , nastavte DataField vlastnost na název pole. Na hodnotu pole můžete použít vlastní formátovací řetězec nastavením DataFormatString vlastnosti. Ve výchozím nastavení se řetězec formátování použije na hodnoty polí pouze v případech, kdy je ovládací prvek vázané na data v režimu jen pro čtení. Chcete-li použít formátovací řetězec na hodnoty zobrazené, zatímco ovládací prvek vázané na data je v režimu úprav, nastavte ApplyFormatInEditMode vlastnost na true. Pokud je nullhodnota pole, můžete vlastní titulek zobrazit nastavením NullDisplayText vlastnosti. Objekt DynamicField může také automaticky převést hodnoty prázdného řetězce ("") na hodnoty null nastavením ConvertEmptyStringToNull vlastnosti na true.

Deklarativní syntaxe

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

Konstruktory

DynamicField()

Inicializuje novou instanci DynamicField třídy.

Vlastnosti

AccessibleHeaderText	Získá nebo nastaví text, který je vykreslen jako `AbbreviatedText` hodnota vlastnosti v některých ovládacích prvcích. (Zděděno od DataControlField)
ApplyFormatInEditMode	Získá nebo nastaví hodnotu, která označuje, zda formátovaný řetězec, který je určen vlastností DataFormatString , je použit na hodnotu pole, když je datové pole v režimu úprav.
Column	MetaColumn Získá objekt, ke kterému je tento DynamicField objekt přidružen.
Control	Získá odkaz na ovládací prvek dat, ke kterému DataControlField je objekt přidružen. (Zděděno od DataControlField)
ControlStyle	Získá styl všech webových server ovládacích prvků obsažených objektem DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu, která označuje, zda prázdné řetězcové hodnoty ("") jsou při aktualizaci datového pole ve zdroji dat automaticky převedeny na hodnoty null.
DataField	Získá nebo nastaví název datového pole pro vytvoření vazby objektu DynamicField na.
DataFormatString	Získá nebo nastaví řetězec, který určuje formát zobrazení pro hodnotu datového pole.
DesignMode	Získá hodnotu označující, zda je pole ovládacího prvku dat aktuálně zobrazeno v návrhovém prostředí. (Zděděno od DataControlField)
FooterStyle	Získá nebo nastaví styl zápatí pole ovládacího prvku dat. (Zděděno od DataControlField)
FooterText	Získá nebo nastaví text, který je zobrazen v zápatí položky pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderImageUrl	Získá nebo nastaví adresu URL obrázku, který se zobrazí v položce záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderStyle	Získá nebo nastaví styl záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderText	Získá nebo nastaví text, který je zobrazen v záhlaví ovládacího prvku vázaného na data, který obsahuje DynamicField objekt.
HtmlEncode	Získá nebo nastaví hodnotu, která označuje, zda hodnoty datových polí jsou kódovány HTML před jejich zobrazením v objektu DynamicField .
InsertVisible	Získá hodnotu označující, zda DataControlField je objekt viditelný, když je nadřazený ovládací prvek vázané na data v režimu vložení. (Zděděno od DataControlField)
IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do stavu zobrazení. (Zděděno od DataControlField)
ItemStyle	Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat. (Zděděno od DataControlField)
NullDisplayText	Získá nebo nastaví titulek, který se zobrazí pro datové pole, když je `null`hodnota pole .
ReadOnly	Získá stav dynamického pole jen pro čtení.
ShowHeader	Získá nebo nastaví hodnotu určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který se používá při použití datového pole k řazení zdroje dat podle.
UIHint	Získá nebo nastaví šablonu pole pro zobrazení datového pole.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta. (Zděděno od DataControlField)
ValidationGroup	ValidationGroup Získá objekt, ke kterému je tento DynamicField objekt přidružen.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav DataControlField zobrazení objektu napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu označující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

CloneField()	Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu. (Zděděno od DataControlField)
ConfigureDynamicControl(DynamicControl)	Poskytuje mechanismus pro úpravu objektu DynamicControl vytvořeného metodou InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) .
CopyProperties(DataControlField)	Zkopíruje vlastnosti aktuálního DynamicField objektu do zadaného DataControlField objektu.
CreateDynamicControl()	Poskytuje mechanismus pro třídy odvozené od DynamicField přepsání způsobu vytvoření objektu DynamicControl .
CreateField()	Vytvoří a vrátí novou instanci DynamicField třídy.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrahuje hodnotu datového pole z aktuální buňky tabulky a přidá hodnotu do zadaného slovníku.
GetAttribute(String)	Načte zadanou hodnotu atributu.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Initialize(Boolean, Control)	Provede základní inicializaci instance pro pole ovládacího prvku dat. (Zděděno od DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Přidá text nebo ovládací prvky do zadané buňky.
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od DataControlField)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnFieldChanged()	Vyvolá `FieldChanged` událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publikována zpět na server. (Zděděno od DataControlField)
SetAttribute(String, String)	Nastaví atribut přidružený k objektu DynamicField .
ToString()	Vrátí řetězec, který představuje tento DataControlField objekt. (Zděděno od DataControlField)
TrackViewState()	Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataControlField)
ValidateSupportsCallback()	Při přepsání v odvozené třídě signalizuje, že ovládací prvky obsažené v poli podporují zpětné volání. (Zděděno od DataControlField)

Explicitní implementace rozhraní

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu. (Zděděno od DataControlField)
IStateManager.IsTrackingViewState	Získá hodnotu označující, zda DataControlField objekt ukládá změny do stavu zobrazení. (Zděděno od DataControlField)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat. (Zděděno od DataControlField)
IStateManager.SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publikována zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataControlField)

Metody rozšíření

ConvertEditedValue(IFieldFormattingOptions, String)	Vrátí hodnotu poskytnutou uživatelem pro ovládací prvek, který se ověřuje.
FormatEditValue(IFieldFormattingOptions, Object)	Formátuje zadanou hodnotu pole pomocí zadaných možností formátování.
FormatValue(IFieldFormattingOptions, Object)	Formátuje zadanou hodnotu pole pomocí zadaných možností formátování.

Platí pro