AutoGeneratedField 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示数据绑定控件中自动生成的字段。 此类不能被继承。
public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundFieldpublic sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundFieldtype AutoGeneratedField = class
inherit BoundFieldPublic NotInheritable Class AutoGeneratedField
Inherits BoundField- 继承
示例
以下示例演示如何为派生自 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 |
获取或设置某些控件中呈现为 |
| ApplyFormatInEditMode |
获取或设置一个值，该值指示包含 DataFormatString 对象的数据绑定控件处于编辑模式时，BoundField 属性指定的格式化字符串是否应用到字段值。 (继承自 BoundField) |
| Control |
获取对数据控件的引用，该控件与 DataControlField 对象关联。 (继承自 DataControlField) |
| ControlStyle |
获取 DataControlField 对象所包含的任何 Web 服务器控件的样式。 (继承自 DataControlField) |
| ConvertEmptyStringToNull |
获取或设置一个值，该值指示在从数据源检索字段值时，是否将空字符串 ("") 值转换为 |
| 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) |
方法
显式接口实现
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
获取或设置与此 DataControlField 对象关联的架构。 (继承自 DataControlField) |
| IStateManager.IsTrackingViewState |
获取一个值，该值指示 DataControlField 对象是否保存对其视图状态的更改。 (继承自 DataControlField) |
| IStateManager.LoadViewState(Object) |
将数据控件字段还原为保存过的前一视图状态。 (继承自 DataControlField) |
| IStateManager.SaveViewState() |
保存在页回发到服务器后对 DataControlField 视图状态所做的更改。 (继承自 DataControlField) |
| IStateManager.TrackViewState() |
使 DataControlField 对象跟踪对其视图状态所做的更改，以便这些更改可以存储在控件的 ViewState 属性中并且能够在同一页的不同请求间得以保持。 (继承自 DataControlField) |
