DynamicField Kelas

Definisi

Ruang nama:: System.Web.DynamicData

Rakitan:: System.Web.DynamicData.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili bidang data yang ditampilkan dalam kontrol terikat data yang menggunakan fitur data dinamis 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

Warisan: Object

DataControlField
DynamicField

Penerapan: IFieldFormattingOptions IAttributeAccessor

Contoh

Contoh berikut menunjukkan cara menggunakan DynamicField objek dalam GridView kontrol untuk menampilkan dan mengedit nilai dari tabel database.

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

Keterangan

Dalam topik ini:

Pendahuluan
SintaksIs Deklaratif

Pendahuluan

Kelas DynamicField ini digunakan oleh kontrol terikat data, seperti GridView kontrol dan DetailsView , untuk menampilkan nilai bidang yang menggunakan fitur data dinamis ASP.NET di halaman kustom.

Kelas ini DynamicField menyediakan fungsionalitas yang menyerupan BoundField kelas. Namun, karena DynamicField objek digunakan dalam aplikasi Data Dinamis, Anda dapat memanfaatkan fitur Data Dinamis berikut:

Secara otomatis merender kontrol yang tepat untuk bidang dengan menggunakan templat bidang, berdasarkan jenis data. Templat bidang dapat dimodifikasi secara global untuk seluruh aplikasi.
Menyediakan validasi data bawaan berdasarkan skema database. Anda juga dapat menambahkan jenis validasi dengan menyesuaikan model data.
Menyesuaikan penyajian data untuk bidang individual dengan menggunakan atribut dalam model data atau dengan menggunakan UIHint properti .

Objek DynamicField merender setiap bidang dengan menggunakan DynamicControl kontrol. Untuk menentukan bidang data yang DynamicField akan ditampilkan dalam objek, atur DataField properti ke nama bidang. Anda bisa menerapkan string pemformatan kustom ke nilai bidang dengan mengatur DataFormatString properti . Secara default string pemformatan diterapkan ke nilai bidang hanya ketika kontrol terikat data berada dalam mode baca-saja. Untuk menerapkan string pemformatan ke nilai yang ditampilkan saat kontrol terikat data dalam mode edit, atur ApplyFormatInEditMode properti ke true. Jika nilai bidang adalah null, Anda dapat menampilkan keterangan kustom dengan mengatur NullDisplayText properti . Objek DynamicField juga dapat secara otomatis mengonversi nilai bidang string kosong ("") menjadi nilai null dengan mengatur ConvertEmptyStringToNull properti ke true.

SintaksIs Deklaratif

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

Konstruktor

Nama	Deskripsi
DynamicField()	Menginisialisasi instans baru dari kelas DynamicField.

Properti

Nama	Deskripsi
AccessibleHeaderText	Mendapatkan atau mengatur teks yang dirender sebagai `AbbreviatedText` nilai properti dalam beberapa kontrol. (Diperoleh dari DataControlField)
ApplyFormatInEditMode	Mendapatkan atau mengatur nilai yang menunjukkan apakah string yang diformat yang ditentukan oleh DataFormatString properti diterapkan ke nilai bidang saat bidang data berada dalam mode edit.
Column	MetaColumn Mendapatkan objek yang dikaitkan dengan objek iniDynamicField.
Control	Mendapatkan referensi ke kontrol data yang DataControlField terkait dengan objek. (Diperoleh dari DataControlField)
ControlStyle	Mendapatkan gaya kontrol server Web apa pun yang terkandung oleh DataControlField objek. (Diperoleh dari DataControlField)
ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai string kosong ("") secara otomatis dikonversi ke nilai null saat bidang data diperbarui di sumber data.
DataField	Mendapatkan atau mengatur nama bidang data untuk mengikat DynamicField objek.
DataFormatString	Mendapatkan atau mengatur string yang menentukan format tampilan untuk nilai bidang data.
DesignMode	Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain. (Diperoleh dari DataControlField)
FooterStyle	Mendapatkan atau mengatur gaya footer bidang kontrol data. (Diperoleh dari DataControlField)
FooterText	Mendapatkan atau mengatur teks yang ditampilkan dalam item footer bidang kontrol data. (Diperoleh dari DataControlField)
HeaderImageUrl	Mendapatkan atau mengatur URL gambar yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField)
HeaderStyle	Mendapatkan atau mengatur gaya header bidang kontrol data. (Diperoleh dari DataControlField)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di header kontrol terikat data yang berisi DynamicField objek.
HtmlEncode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang data dikodekan HTML sebelum ditampilkan dalam DynamicField objek.
InsertVisible	Mendapatkan nilai yang menunjukkan apakah DataControlField objek terlihat ketika kontrol terikat data induknya berada dalam mode sisipkan. (Diperoleh dari DataControlField)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField)
ItemStyle	Mendapatkan gaya konten berbasis teks apa pun yang ditampilkan oleh bidang kontrol data. (Diperoleh dari DataControlField)
NullDisplayText	Mendapatkan atau mengatur keterangan yang ditampilkan untuk bidang data saat nilai bidang adalah `null`.
ReadOnly	Mendapatkan status baca-saja dari bidang dinamis.
ShowHeader	Mendapatkan atau mengatur nilai yang menunjukkan apakah item header bidang kontrol data dirender. (Diperoleh dari DataControlField)
SortExpression	Mendapatkan atau mengatur ekspresi pengurutan yang digunakan saat bidang data digunakan untuk mengurutkan sumber data.
UIHint	Mendapatkan atau mengatur templat bidang yang akan digunakan untuk menampilkan bidang data.
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien.
ValidationGroup	ValidationGroup Mendapatkan objek yang dikaitkan dengan objek iniDynamicField.
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataControlField tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang kontrol data dirender. (Diperoleh dari DataControlField)

Metode

Nama	Deskripsi
CloneField()	Membuat salinan duplikat dari objek -turunan saat ini DataControlField. (Diperoleh dari DataControlField)
ConfigureDynamicControl(DynamicControl)	Menyediakan mekanisme untuk mengubah DynamicControl objek yang dibuat oleh InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) metode .
CopyProperties(DataControlField)	Menyalin properti objek saat ini DynamicField ke objek yang ditentukan DataControlField .
CreateDynamicControl()	Menyediakan mekanisme untuk kelas yang berasal dari DynamicField untuk mengambil alih cara DynamicControl objek dibuat.
CreateField()	Membuat dan mengembalikan instans DynamicField baru kelas.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Mengekstrak nilai bidang data dari sel tabel saat ini dan menambahkan nilai ke kamus yang ditentukan.
GetAttribute(String)	Mengambil nilai atribut yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
Initialize(Boolean, Control)	Melakukan inisialisasi instans dasar untuk bidang kontrol data. (Diperoleh dari DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Menambahkan teks atau kontrol ke sel yang ditentukan.
LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari DataControlField)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnFieldChanged()	Menaikkan peristiwa `FieldChanged`. (Diperoleh dari DataControlField)
SaveViewState()	Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField)
SetAttribute(String, String)	Mengatur atribut yang terkait dengan DynamicField objek.
ToString()	Mengembalikan string yang mewakili objek ini DataControlField . (Diperoleh dari DataControlField)
TrackViewState()	DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
ValidateSupportsCallback()	Saat ditimpa di kelas turunan, menandakan bahwa kontrol yang dimuat oleh bidang mendukung panggilan balik. (Diperoleh dari DataControlField)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Mendapatkan atau mengatur skema yang terkait dengan objek ini DataControlField . (Diperoleh dari DataControlField)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya di bidang kontrol data. (Diperoleh dari DataControlField)
IStateManager.SaveViewState()	Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField)
IStateManager.TrackViewState()	DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)

Metode Ekstensi

Nama	Deskripsi
ConvertEditedValue(IFieldFormattingOptions, String)	Mengembalikan nilai yang disediakan oleh pengguna untuk kontrol yang sedang divalidasi.
FormatEditValue(IFieldFormattingOptions, Object)	Memformat nilai bidang yang ditentukan dengan menggunakan opsi pemformatan yang ditentukan.
FormatValue(IFieldFormattingOptions, Object)	Memformat nilai bidang yang ditentukan dengan menggunakan opsi pemformatan yang ditentukan.

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?