AutoGeneratedField 类

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

表示数据绑定控件中自动生成的字段。 此类不能被继承。

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

继承

Object

DataControlField

BoundField

AutoGeneratedField

示例

以下示例演示如何为派生自 DetailsView 该控件的自定义控件创建 AutoGeneratedField 对象。

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

注解

类 AutoGeneratedField 用于表示数据绑定控件中自动生成的字段，例如 GridView 或 DetailsView。 当适当的属性设置为 true (时，自动生成的字段由数据绑定控件创建，例如， AutoGenerateColumns 控件的 GridView 属性、 AutoGenerateRows 控件的 DetailsView 属性等) 。

注意

自动生成的字段不会添加到数据绑定控件的字段集合 (例如， Columns 控件的 GridView 集合、 Fields 控件的 DetailsView 集合等) 。

类 AutoGeneratedField 旨在供数据绑定控件在内部使用。 与) 的其他数据字段 (（如 BoundField、 CheckBoxField、 TemplateField等）不同， AutoGeneratedField 类不能作为字段集合的一部分以声明方式放置在页面上。 尽管可以通过编程方式将对象添加到 AutoGeneratedField 字段集合，但应避免此设计模式。

由于自动生成的字段表示字段的自动呈现，因此数据绑定控件通常不允许用户修改对象的属性 AutoGeneratedField 。 如果自动呈现不适合你的需求，请为控件的字段集合定义你自己的数据字段。

构造函数

AutoGeneratedField(String)

用指定的数据字段初始化 AutoGeneratedField 类的新实例。

属性

AccessibleHeaderText	获取或设置某些控件中呈现为 AbbreviatedText 属性值的文本。 (继承自 DataControlField)
ApplyFormatInEditMode	获取或设置一个值，该值指示包含 DataFormatString 对象的数据绑定控件处于编辑模式时，BoundField 属性指定的格式化字符串是否应用到字段值。 (继承自 BoundField)
Control	获取对数据控件的引用，该控件与 DataControlField 对象关联。 (继承自 DataControlField)
ControlStyle	获取 DataControlField 对象所包含的任何 Web 服务器控件的样式。 (继承自 DataControlField)
ConvertEmptyStringToNull	获取或设置一个值，该值指示在从数据源检索字段值时，是否将空字符串 ("") 值转换为 null。
DataField	获取或设置要绑定到 BoundField 对象的数据字段的名称。 (继承自 BoundField)
DataFormatString	获取或设置一个字符串，该字符串指定 AutoGeneratedField 对象中每个图像的备用文本所呈现的格式。
DataType	获取或设置在 AutoGeneratedField 对象中显示的值的数据类型。
DesignMode	获取一个值，该值指示数据控件字段当前是否在设计时环境中进行查看。 (继承自 DataControlField)
FooterStyle	获取或设置数据控件字段脚注的样式。 (继承自 DataControlField)
FooterText	获取或设置数据控件字段的脚注项中显示的文本。 (继承自 DataControlField)
HeaderImageUrl	获取或设置数据控件字段的标题项中显示的图像的 URL。 (继承自 DataControlField)
HeaderStyle	获取或设置数据控件字段标头的样式。 (继承自 DataControlField)
HeaderText	获取或设置显示在数据控件标头中的文本。 (继承自 BoundField)
HtmlEncode	获取或设置一个值，该值指示在 BoundField 对象中显示字段值之前，是否对这些字段值进行 HTML 编码。 (继承自 BoundField)
HtmlEncodeFormatString	获取或设置一个值，该值指示通过将 DataFormatString 属性应用于 BoundField 值而创建的文本在显示时是否应经过 HTML 编码。 (继承自 BoundField)
InsertVisible	获取或设置一个值，该值指示 AutoGeneratedField 对象在插入模式中是否可见。
IsTrackingViewState	获取一个值，该值指示 DataControlField 对象是否保存对其视图状态的更改。 (继承自 DataControlField)
ItemStyle	获取由数据控件字段显示的任何基于文本的内容的样式。 (继承自 DataControlField)
NullDisplayText	获取或设置当字段值为 null 时为字段显示的标题。 (继承自 BoundField)
ReadOnly	获取或设置一个值，该值指示是否可以在编辑模式中修改字段的值。 (继承自 BoundField)
ShowHeader	获取或设置一个值，该值指示是否呈现数据控件字段的标题项。 (继承自 DataControlField)
SortExpression	获取或设置数据源控件用来对数据进行排序的排序表达式。 (继承自 DataControlField)
SupportsHtmlEncode	获取一个值，该值指示 BoundField 对象是否支持 HTML 编码。 (继承自 BoundField)
ValidateRequestMode	获取或设置确定控件是否验证客户端输入的值。 (继承自 BoundField)
ViewState	获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原 DataControlField 对象的视图状态。 (继承自 DataControlField)
Visible	获取或设置指示是否呈现数据控件字段的值。 (继承自 DataControlField)

方法

CloneField()	创建当前 DataControlField 派生对象的副本。 (继承自 DataControlField)
CopyProperties(DataControlField)	将当前 BoundField 对象的属性复制到指定的 DataControlField 对象。 (继承自 BoundField)
CreateField()	创建一个空的 BoundField 对象。 (继承自 BoundField)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	使用指定的 IOrderedDictionary 对象中的值填充指定的 DataControlFieldCell 对象。
FormatDataValue(Object, Boolean)	设定 BoundField 对象内的单元格中的指定字段值。 (继承自 BoundField)
GetDesignTimeValue()	在设计器中呈现 BoundField 对象时，检索用作字段值的值。 (继承自 BoundField)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(Control)	检索绑定到 BoundField 对象的字段值。 (继承自 BoundField)
Initialize(Boolean, Control)	初始化 BoundField 对象。 (继承自 BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	将指定的 TableCell 对象初始化为指定的行状态。 (继承自 BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	将指定的 TableCell 对象初始化为指定的行状态。 (继承自 BoundField)
LoadViewState(Object)	还原以前为此字段存储的视图状态信息。 (继承自 BoundField)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnDataBindField(Object, EventArgs)	将字段值绑定到 BoundField 对象。 (继承自 BoundField)
OnFieldChanged()	引发 FieldChanged 事件。 (继承自 DataControlField)
SaveViewState()	保存在页回发到服务器后对 DataControlField 视图状态所做的更改。 (继承自 DataControlField)
ToString()	返回表示此 DataControlField 对象的字符串。 (继承自 DataControlField)
TrackViewState()	使 DataControlField 对象跟踪对其视图状态所做的更改，以便这些更改可以存储在控件的 ViewState 属性中并且能够在同一页的不同请求间得以保持。 (继承自 DataControlField)
ValidateSupportsCallback()	确定 AutoGeneratedField 对象中所包含的控件是否支持回调。

显式接口实现

IDataSourceViewSchemaAccessor.DataSourceViewSchema	获取或设置与此 DataControlField 对象关联的架构。 (继承自 DataControlField)
IStateManager.IsTrackingViewState	获取一个值，该值指示 DataControlField 对象是否保存对其视图状态的更改。 (继承自 DataControlField)
IStateManager.LoadViewState(Object)	将数据控件字段还原为保存过的前一视图状态。 (继承自 DataControlField)
IStateManager.SaveViewState()	保存在页回发到服务器后对 DataControlField 视图状态所做的更改。 (继承自 DataControlField)
IStateManager.TrackViewState()	使 DataControlField 对象跟踪对其视图状态所做的更改，以便这些更改可以存储在控件的 ViewState 属性中并且能够在同一页的不同请求间得以保持。 (继承自 DataControlField)

另请参阅

• DetailsView
• GridView
• AutoGeneratedFieldProperties
• BoundField
• ButtonField
• CheckBoxField
• CommandField
• HyperLinkField
• ImageField
• TemplateField
• Columns
• Fields
• CreateAutoGeneratedColumn(AutoGeneratedFieldProperties)
• CreateAutoGeneratedRow(AutoGeneratedFieldProperties)