DynamicField Třída

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á funkce ASP.NET 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

Následující příklad ukazuje použití DynamicField objektu 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:

Introduction
Deklarativní syntaxe

Introduction

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

Třída DynamicField poskytuje funkce, které se podobají třídě BoundField . Vzhledem k tomu, že se DynamicField 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 vykresluje 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 formátovací řetězec použije na hodnoty polí, pouze pokud 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 zobrazit vlastní titulek 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

Name	Description
DynamicField()	Inicializuje novou instanci DynamicField třídy.

Vlastnosti

Name	Description
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á určuje, zda formátovaný řetězec, který je určen DataFormatString vlastností je použit na hodnotu pole, když datové pole je 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 ovládacích prvků webového serveru obsažené objektu DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu, která označuje, zda prázdné řetězcové hodnoty ("") jsou automaticky převedeny na hodnoty null při aktualizaci datového pole ve zdroji dat.
DataField	Získá nebo nastaví název datového pole pro vazbu 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 pole ovládacího prvku dat je 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 zobrazený v záhlaví ovládacího prvku vázaného na data, který obsahuje DynamicField objekt.
HtmlEncode	Získá nebo nastaví hodnotu, která určuje, zda hodnoty datových polí jsou kódovány HTML před jejich zobrazením v objektu DynamicField .
InsertVisible	Získá hodnotu určující, zda DataControlField objekt je viditelný, když nadřazený ovládací prvek vázané na data je 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 jeho 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.
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 zobrazení objektu DataControlField napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu určující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

Name	Description
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čuje, zda je zadaný objekt roven 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()	Získá Type aktuální instance. (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ří mělkou kopii aktuálního Object. (Zděděno od Object)
OnFieldChanged()	`FieldChanged` Vyvolá událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslá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í, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)
ValidateSupportsCallback()	Při přepsání v odvozené třídě signály, že ovládací prvky obsažené v poli podporují zpětná volání. (Zděděno od DataControlField)

Explicitní implementace rozhraní

Name	Description
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 určující, zda DataControlField objekt ukládá změny do jeho 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 odeslána zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)

Metody rozšíření

Name	Description
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é

Váš názor

Byla tato stránka užitečná?