Udostępnij za pośrednictwem


DynamicField Klasa

Definicja

Reprezentuje pole danych wyświetlane w kontrolce powiązanej z danymi, które korzysta z funkcji danych dynamicznych ASP.NET.

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

Przykłady

Zobacz przykład kodu w czasie wykonywania tej funkcji: Uruchom.

W poniższym przykładzie pokazano, jak używać DynamicField obiektu w kontrolce GridView do wyświetlania i edytowania wartości z tabeli bazy danych.

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

Uwagi

W tym temacie:

Wprowadzenie

Klasa DynamicField jest używana przez kontrolki powiązane z danymi, takie jak kontrolki GridView iDetailsView, do wyświetlania wartości pola, która używa funkcji danych dynamicznych ASP.NET na stronach niestandardowych.

Klasa DynamicField udostępnia funkcje przypominające klasę BoundField . Jednak ponieważ DynamicField obiekt jest używany w aplikacjach danych dynamicznych, możesz skorzystać z następujących funkcji danych dynamicznych:

  • Automatyczne renderowanie właściwej kontrolki dla pola przy użyciu szablonów pól na podstawie typu danych. Szablony pól można modyfikować globalnie dla całej aplikacji.

  • Zapewnianie wbudowanej weryfikacji danych na podstawie schematu bazy danych. Możesz również dodać typy weryfikacji, dostosowując model danych.

  • Dostosowywanie renderowania danych dla poszczególnych pól przy użyciu atrybutów w modelu danych lub za pomocą UIHint właściwości .

Obiekt DynamicField renderuje każde pole przy użyciu kontrolki DynamicControl . Aby określić pole danych do wyświetlenia w DynamicField obiekcie, ustaw DataField właściwość na nazwę pola. Możesz zastosować niestandardowy ciąg formatowania do wartości pola, ustawiając DataFormatString właściwość . Domyślnie ciąg formatowania jest stosowany do wartości pól tylko wtedy, gdy kontrolka powiązana z danymi jest w trybie tylko do odczytu. Aby zastosować ciąg formatowania do wartości wyświetlanych, gdy kontrolka powiązana z danymi jest w trybie edycji, ustaw ApplyFormatInEditMode właściwość na truewartość . Jeśli wartość pola to null, możesz wyświetlić podpis niestandardowy, ustawiając NullDisplayText właściwość . Obiekt DynamicField może również automatycznie konwertować wartości pól pustych ("") na wartości null, ustawiając ConvertEmptyStringToNull właściwość na truewartość .

Składnia deklaracyjna

<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()

Inicjuje nowe wystąpienie klasy DynamicField.

Właściwości

AccessibleHeaderText

Pobiera lub ustawia tekst renderowany jako AbbreviatedText wartość właściwości w niektórych kontrolkach.

(Odziedziczone po DataControlField)
ApplyFormatInEditMode

Pobiera lub ustawia wartość wskazującą, czy sformatowany ciąg określony przez DataFormatString właściwość jest stosowany do wartości pola, gdy pole danych jest w trybie edycji.

Column

MetaColumn Pobiera obiekt skojarzony z tym DynamicField obiektem.

Control

Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem.

(Odziedziczone po DataControlField)
ControlStyle

Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie.

(Odziedziczone po DataControlField)
ConvertEmptyStringToNull

Pobiera lub ustawia wartość wskazującą, czy wartości pustych ciągów ("") są automatycznie konwertowane na wartości null po zaktualizowaniu pola danych w źródle danych.

DataField

Pobiera lub ustawia nazwę pola danych, aby powiązać DynamicField obiekt z.

DataFormatString

Pobiera lub ustawia ciąg określający format wyświetlania dla wartości pola danych.

DesignMode

Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania.

(Odziedziczone po DataControlField)
FooterStyle

Pobiera lub ustawia styl stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
FooterText

Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderImageUrl

Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderStyle

Pobiera lub ustawia styl nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderText

Pobiera lub ustawia tekst wyświetlany w nagłówku kontrolki powiązanej z danymi, która zawiera DynamicField obiekt.

HtmlEncode

Pobiera lub ustawia wartość wskazującą, czy wartości pól danych są zakodowane w formacie HTML przed ich wyświetleniem DynamicField w obiekcie.

InsertVisible

Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka związana z danymi jest w trybie wstawiania.

(Odziedziczone po DataControlField)
IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
ItemStyle

Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych.

(Odziedziczone po DataControlField)
NullDisplayText

Pobiera lub ustawia podpis wyświetlany dla pola danych, gdy wartość pola to null.

ReadOnly

Pobiera stan pola dynamicznego tylko do odczytu.

ShowHeader

Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany.

(Odziedziczone po DataControlField)
SortExpression

Pobiera lub ustawia wyrażenie sortowania, które jest używane, gdy pole danych jest używane do sortowania źródła danych według.

UIHint

Pobiera lub ustawia szablon pola do użycia do wyświetlania pola danych.

ValidateRequestMode

Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta.

ValidateRequestMode

Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta.

(Odziedziczone po DataControlField)
ValidationGroup

ValidationGroup Pobiera obiekt skojarzony z tym DynamicField obiektem.

ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
Visible

Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane.

(Odziedziczone po DataControlField)

Metody

CloneField()

Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego.

(Odziedziczone po DataControlField)
ConfigureDynamicControl(DynamicControl)

Udostępnia mechanizm modyfikowania DynamicControl obiektu, który został utworzony przez metodę InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) .

CopyProperties(DataControlField)

Kopiuje właściwości bieżącego DynamicField obiektu do określonego DataControlField obiektu.

CreateDynamicControl()

Zapewnia mechanizm dla klas, które pochodzą z DynamicField , aby zastąpić sposób DynamicControl tworzenia obiektu.

CreateField()

Tworzy i zwraca nowe wystąpienie DynamicField klasy .

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Wyodrębnia wartość pola danych z bieżącej komórki tabeli i dodaje wartość do określonego słownika.

GetAttribute(String)

Pobiera określoną wartość atrybutu.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
Initialize(Boolean, Control)

Wykonuje inicjowanie podstawowego wystąpienia dla pola kontrolki danych.

(Odziedziczone po DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Dodaje tekst lub kontrolki do określonej komórki.

LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku źródła danych.

(Odziedziczone po DataControlField)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnFieldChanged()

FieldChanged Zgłasza zdarzenie.

(Odziedziczone po DataControlField)
SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
SetAttribute(String, String)

Ustawia atrybut skojarzony z obiektem DynamicField .

ToString()

Zwraca ciąg reprezentujący ten DataControlField obiekt.

(Odziedziczone po DataControlField)
TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
ValidateSupportsCallback()

Po zastąpieniu w klasie pochodnej sygnały, że kontrolki zawarte przez wywołania zwrotne obsługi pól.

(Odziedziczone po DataControlField)

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem.

(Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku pola kontroli danych.

(Odziedziczone po DataControlField)
IStateManager.SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
IStateManager.TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)

Metody rozszerzania

ConvertEditedValue(IFieldFormattingOptions, String)

Zwraca wartość podaną przez użytkownika dla kontrolki, która jest weryfikowana.

FormatEditValue(IFieldFormattingOptions, Object)

Formatuje określoną wartość pola przy użyciu określonych opcji formatowania.

FormatValue(IFieldFormattingOptions, Object)

Formatuje określoną wartość pola przy użyciu określonych opcji formatowania.

Dotyczy

Zobacz też