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 CheckBoxField, , TemplateFieldи т. д.), 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	Возвращает или задает заголовок, отображаемый для поля, если значение поля равно 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)

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через