AutoGeneratedField Kelas

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.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 yang dihasilkan secara otomatis dalam kontrol terikat data. Kelas ini tidak dapat diwariskan.

public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundField

public sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundField

type AutoGeneratedField = class
    inherit BoundField

Public NotInheritable Class AutoGeneratedField
Inherits BoundField

Warisan: Object

DataControlField

BoundField
AutoGeneratedField

Contoh

Contoh berikut menunjukkan cara membuat AutoGeneratedField objek untuk kontrol kustom yang berasal dari DetailsView kontrol.


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;
using System.Web;

namespace Samples.AspNet.CS.Controls
{

    [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    public class SimpleCustomControl : DetailsView
    {

        protected override AutoGeneratedField CreateAutoGeneratedRow(AutoGeneratedFieldProperties fieldProperties)
        {

            // Create an AutoGeneratedField object.
            AutoGeneratedField field = new AutoGeneratedField(fieldProperties.DataField);

            // Set the properties of the AutoGeneratedField using
            // the values from the AutoGeneratedFieldProperties
            // object contained in the fieldProperties parameter.
            ((IStateManager)field).TrackViewState();
            field.HeaderText = fieldProperties.Name;
            field.SortExpression = fieldProperties.Name;
            field.ReadOnly = fieldProperties.IsReadOnly;
            field.DataType = fieldProperties.Type;

            return field;
        }
    }
}


Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports System.Web

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal), AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.DetailsView

        Protected Overrides Function CreateAutoGeneratedRow(ByVal fieldProperties As AutoGeneratedFieldProperties) As AutoGeneratedField

            ' Create an AutoGeneratedField object.
            Dim field As New AutoGeneratedField(fieldProperties.DataField)

            ' Set the properties of the AutoGeneratedField using
            ' the values from the AutoGeneratedFieldProperties 
            ' object contained in the fieldProperties parameter.
            CType(field, IStateManager).TrackViewState()
            field.HeaderText = fieldProperties.Name
            field.SortExpression = fieldProperties.Name
            field.ReadOnly = fieldProperties.IsReadOnly
            field.DataType = fieldProperties.Type

            Return field

        End Function

    End Class

End Namespace

Keterangan

Kelas AutoGeneratedField ini digunakan untuk mewakili bidang yang dihasilkan secara otomatis dalam kontrol terikat data, seperti GridView atau DetailsView. Bidang yang dihasilkan secara otomatis dibuat oleh kontrol terikat data saat properti yang sesuai diatur ke true (misalnya, AutoGenerateColumns properti untuk GridView kontrol, AutoGenerateRows properti untuk DetailsView kontrol, dan sebagainya).

Nota

Bidang yang dihasilkan secara otomatis tidak ditambahkan ke kumpulan bidang kontrol terikat data (misalnya, Columns koleksi untuk GridView kontrol, Fields koleksi untuk DetailsView kontrol, dan sebagainya).

Kelas AutoGeneratedField ini ditujukan untuk digunakan secara internal oleh kontrol terikat data. Tidak seperti bidang data lain (seperti BoundField, , CheckBoxField TemplateField, dan sebagainya), AutoGeneratedField kelas tidak dapat ditempatkan secara deklaratif di halaman sebagai bagian dari kumpulan bidang. Meskipun Anda dapat secara terprogram menambahkan AutoGeneratedField objek ke koleksi bidang, pola desain ini harus dihindari.

Karena bidang yang dihasilkan secara otomatis mewakili penyajian otomatis bidang, kontrol terikat data biasanya tidak memungkinkan pengguna untuk memodifikasi properti AutoGeneratedField objek. Jika penyajian otomatis tidak cocok untuk kebutuhan Anda, tentukan bidang data Anda sendiri untuk kumpulan bidang kontrol.

Konstruktor

Nama	Deskripsi
AutoGeneratedField(String)	Menginisialisasi instans AutoGeneratedField baru kelas dengan bidang data yang ditentukan.

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 pemformatan yang ditentukan oleh DataFormatString properti diterapkan ke nilai bidang saat kontrol terikat data yang berisi BoundField objek berada dalam mode edit. (Diperoleh dari BoundField)
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 ("") dikonversi menjadi `null` saat nilai bidang diambil dari sumber data.
DataField	Mendapatkan atau mengatur nama bidang data yang akan diikat ke BoundField objek. (Diperoleh dari BoundField)
DataFormatString	Mendapatkan atau mengatur string yang menentukan format di mana teks alternatif untuk setiap gambar dalam AutoGeneratedField objek dirender.
DataType	Mendapatkan atau mengatur jenis data nilai yang ditampilkan dalam AutoGeneratedField objek.
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 data. (Diperoleh dari BoundField)
HtmlEncode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang dikodekan HTML sebelum ditampilkan dalam BoundField objek. (Diperoleh dari BoundField)
HtmlEncodeFormatString	Mendapatkan atau mengatur nilai yang menunjukkan apakah teks yang dibuat dengan menerapkan DataFormatString properti ke BoundField nilai harus dikodekan HTML saat ditampilkan. (Diperoleh dari BoundField)
InsertVisible	Mendapatkan atau mengatur nilai yang menunjukkan apakah AutoGeneratedField objek terlihat dalam mode sisipkan.
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 saat nilai bidang null. (Diperoleh dari BoundField)
ReadOnly	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang dapat dimodifikasi dalam mode edit. (Diperoleh dari BoundField)
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 oleh kontrol sumber data untuk mengurutkan data. (Diperoleh dari DataControlField)
SupportsHtmlEncode	Mendapatkan nilai yang menunjukkan apakah pengodean HTML didukung oleh BoundField objek. (Diperoleh dari BoundField)
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien atau tidak. (Diperoleh dari BoundField)
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)
CopyProperties(DataControlField)	Menyalin properti objek saat ini BoundField ke objek yang ditentukan DataControlField . (Diperoleh dari BoundField)
CreateField()	Membuat objek kosong BoundField . (Diperoleh dari BoundField)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Mengisi objek yang ditentukan IOrderedDictionary dengan nilai dari objek yang ditentukan DataControlFieldCell .
FormatDataValue(Object, Boolean)	Memformat nilai bidang yang ditentukan untuk sel dalam BoundField objek. (Diperoleh dari BoundField)
GetDesignTimeValue()	Mengambil nilai yang digunakan untuk nilai bidang saat merender BoundField objek dalam perancang. (Diperoleh dari BoundField)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(Control)	Mengambil nilai bidang yang terikat ke BoundField objek. (Diperoleh dari BoundField)
Initialize(Boolean, Control)	Menginisialisasi objek BoundField. (Diperoleh dari BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Menginisialisasi objek yang ditentukan TableCell ke status baris yang ditentukan. (Diperoleh dari BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Menginisialisasi objek yang ditentukan TableCell ke status baris yang ditentukan. (Diperoleh dari BoundField)
LoadViewState(Object)	Memulihkan informasi status tampilan yang disimpan sebelumnya untuk bidang ini. (Diperoleh dari BoundField)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnDataBindField(Object, EventArgs)	Mengikat nilai bidang ke BoundField objek. (Diperoleh dari BoundField)
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)
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()	Menentukan apakah kontrol yang terkandung dalam AutoGeneratedField panggilan balik dukungan objek.

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)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?