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

Примеры

В следующем примере показано, как создать AutoGeneratedField объект для пользовательского элемента управления, производного от DetailsView элемента управления.

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, , CheckBoxFieldTemplateFieldи т. д.), AutoGeneratedField класс не может быть декларативно помещен на страницу как часть коллекции полей. Хотя вы можете программно добавить AutoGeneratedField объект в коллекцию полей, следует избегать этого шаблона разработки.

Так как автоматически созданные поля представляют собой автоматическую отрисовку поля, элементы управления с привязкой к данным обычно не позволяют пользователям изменять свойства AutoGeneratedField объектов. Если автоматическая отрисовка не подходит для ваших потребностей, определите собственные поля данных для коллекции полей элемента управления.

Конструкторы

AutoGeneratedField(String)

Инициализирует новый экземпляр класса AutoGeneratedField с указанными полями данных.

Свойства

AccessibleHeaderText	Возвращает или задает текст, отображающийся как значение свойство AbbreviatedText некоторых элементов управления. (Унаследовано от DataControlField)
ApplyFormatInEditMode	Возвращает или задает значение, указывающее на применения форматирующей строки, указанной свойством DataFormatString к значениям поля, если элемент управления, привязанный к данным и содержащий объект BoundField находится в режиме правки. (Унаследовано от BoundField)
Control	Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField. (Унаследовано от DataControlField)
ControlStyle	Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField. (Унаследовано от DataControlField)
ConvertEmptyStringToNull	Получает или задает значение, определяющее, следует ли преобразовывать пустые строки ("") в null при получении значений полей из источника данных.
DataField	Возвращает или задает имя поля данных, привязываемого к объекту BoundField. (Унаследовано от BoundField)
DataFormatString	Получает или задает строку, указывающую формат, в котором передается альтернативный текст для каждого изображения в объекте AutoGeneratedField.
DataType	Возвращает или задает тип данных для значений, отображаемых в объекте AutoGeneratedField.
DesignMode	Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки. (Унаследовано от DataControlField)
FooterStyle	Возвращает или задает стиль нижнего колонтитула поля элемента управления данными. (Унаследовано от DataControlField)
FooterText	Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField)
HeaderImageUrl	Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField)
HeaderStyle	Возвращает или задает стиль верхнего колонтитула поля элемента управления данными. (Унаследовано от DataControlField)
HeaderText	Возвращает или задает текст для отображения в верхнем колонтитуле элемента управления данными. (Унаследовано от BoundField)
HtmlEncode	Возвращает или задает значение, позволяющее определить, следует ли кодировать в HTML значения полей, перед отображением в объекте BoundField. (Унаследовано от BoundField)
HtmlEncodeFormatString	Получает или задает значение, указывающее, нужно ли отображать текст, созданный применением свойства DataFormatString к значению BoundField, в кодировке HTML. (Унаследовано от BoundField)
InsertVisible	Получает или задает значение, определяющее, находится ли объект AutoGeneratedField в режиме вставки или оно отображается.
IsTrackingViewState	Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления. (Унаследовано от DataControlField)
ItemStyle	Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием. (Унаследовано от DataControlField)
NullDisplayText	Возвращает или задает заголовок для поля, имеющего нулевое значение. (Унаследовано от BoundField)
ReadOnly	Возвращает или задает значение, позволяющее определить, можно ли менять значения поля, в режиме редактирования. (Унаследовано от BoundField)
ShowHeader	Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными. (Унаследовано от DataControlField)
SortExpression	Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных. (Унаследовано от DataControlField)
SupportsHtmlEncode	Возвращает значение, указывающее поддержку HTML кодирования объектом BoundField. (Унаследовано от 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)