Sdílet prostřednictvím


DynamicField Třída

Definice

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
DynamicField
Implementuje

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

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

Viz také