AutoGeneratedField AutoGeneratedField AutoGeneratedField AutoGeneratedField Class

Определение

Представляет автоматически созданное поле в элементе управления с привязкой к данным.Represents an automatically generated field in a data-bound control. Этот класс не наследуется.This class cannot be inherited.

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
Наследование

Примеры

Следующий пример демонстрирует создание AutoGeneratedField объекта для пользовательского элемента управления, производный от DetailsView элемента управления.The following example demonstrates how to create an AutoGeneratedField object for a custom control that derives from the DetailsView control.


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.The AutoGeneratedField class is used to represent an automatically generated field in a data-bound control, such as GridView or DetailsView. Автоматически созданные поля создаются путем элемента управления с привязкой данных, если соответствующее свойство имеет значение true (например, AutoGenerateColumns свойство для GridView элемента управления, AutoGenerateRows свойство для DetailsView элемента управления, и так далее).Automatically generated fields are created by a data-bound control when the appropriate property is set to true (for example, the AutoGenerateColumns property for the GridView control, the AutoGenerateRows property for the DetailsView control, and so on).

Примечание

Автоматически созданных полей не добавляются в коллекцию полей элемента управления с привязкой к данным (например, Columns коллекции для GridView элемента управления, Fields коллекции для DetailsView управления и т. д).Automatically generated fields are not added to the field collection of a data-bound control (for example, the Columns collection for the GridView control, the Fields collection for the DetailsView control, and so on).

AutoGeneratedField Класс предназначен для использования внутри элементов управления с привязкой к данным.The AutoGeneratedField class is intended for use internally by data-bound controls. В отличие от других полей данных (таких как BoundField, CheckBoxField, TemplateField, и так далее), AutoGeneratedField класс не может быть помещен декларативно на странице как часть коллекции полей.Unlike other data fields (such as BoundField, CheckBoxField, TemplateField, and so on), the AutoGeneratedField class cannot be placed declaratively on a page as part of a field collection. Несмотря на то, что можно программно добавить AutoGeneratedField объекта на коллекцию полей, следует избегать этого шаблона разработки.Although you can programmatically add an AutoGeneratedField object to a field collection, this design pattern should be avoided.

Так как автоматически созданные поля представляют автоматическую отрисовку поля, элементы управления с привязкой к данным обычно не разрешают пользователям изменять свойства AutoGeneratedField объектов.Because automatically generated fields represent the automatic rendering of a field, data-bound controls do not typically allow users to modify the properties of the AutoGeneratedField objects. Если для автоматической подготовки к просмотру не подходит для ваших потребностей, определите собственные поля данных для коллекции полей элемента управления.If the automatic rendering is not suitable for your needs, define your own data fields for the field collection of the control.

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

AutoGeneratedField(String) AutoGeneratedField(String) AutoGeneratedField(String) AutoGeneratedField(String)

Инициализирует новый экземпляр класса AutoGeneratedField с указанными полями данных.Initializes a new instance of the AutoGeneratedField class with the specified data field.

Свойства

AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText

Возвращает или задает текст, отображающийся как значение свойство AbbreviatedText некоторых элементов управления.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Inherited from DataControlField)
ApplyFormatInEditMode ApplyFormatInEditMode ApplyFormatInEditMode ApplyFormatInEditMode

Возвращает или задает значение, указывающее на применения форматирующей строки, указанной свойством DataFormatString к значениям поля, если элемент управления, привязанный к данным и содержащий объект BoundField находится в режиме правки.Gets or sets a value indicating whether the formatting string specified by the DataFormatString property is applied to field values when the data-bound control that contains the BoundField object is in edit mode.

(Inherited from BoundField)
Control Control Control Control

Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField.Gets a reference to the data control that the DataControlField object is associated with.

(Inherited from DataControlField)
ControlStyle ControlStyle ControlStyle ControlStyle

Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Inherited from DataControlField)
ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull

Получает или задает значение, определяющее, следует ли преобразовывать пустые строки ("") в null при получении значений полей из источника данных.Gets or sets a value indicating whether empty string ("") values are converted to null when the field values are retrieved from the data source.

DataField DataField DataField DataField

Возвращает или задает имя поля данных, привязываемого к объекту BoundField.Gets or sets the name of the data field to bind to the BoundField object.

(Inherited from BoundField)
DataFormatString DataFormatString DataFormatString DataFormatString

Получает или задает строку, указывающую формат, в котором передается альтернативный текст для каждого изображения в объекте AutoGeneratedField.Gets or sets the string that specifies the format in which the alternate text for each image in an AutoGeneratedField object is rendered.

DataType DataType DataType DataType

Возвращает или задает тип данных для значений, отображаемых в объекте AutoGeneratedField.Gets or sets the data type of the values displayed in an AutoGeneratedField object.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Inherited from DataControlField)
FooterStyle FooterStyle FooterStyle FooterStyle

Возвращает или задает стиль нижнего колонтитула поля элемента управления данными.Gets or sets the style of the footer of the data control field.

(Inherited from DataControlField)
FooterText FooterText FooterText FooterText

Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными.Gets or sets the text that is displayed in the footer item of a data control field.

(Inherited from DataControlField)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Inherited from DataControlField)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Возвращает или задает стиль верхнего колонтитула поля элемента управления данными.Gets or sets the style of the header of the data control field.

(Inherited from DataControlField)
HeaderText HeaderText HeaderText HeaderText

Возвращает или задает текст для отображения в верхнем колонтитуле элемента управления данными.Gets or sets the text that is displayed in the header of a data control.

(Inherited from BoundField)
HtmlEncode HtmlEncode HtmlEncode HtmlEncode

Возвращает или задает значение, позволяющее определить, следует ли кодировать в HTML значения полей, перед отображением в объекте BoundField.Gets or sets a value indicating whether field values are HTML-encoded before they are displayed in a BoundField object.

(Inherited from BoundField)
HtmlEncodeFormatString HtmlEncodeFormatString HtmlEncodeFormatString HtmlEncodeFormatString

Получает или задает значение, указывающее, нужно ли отображать текст, созданный применением свойства DataFormatString к значению BoundField, в кодировке HTML.Gets or sets a value that indicates whether text that is created by applying the DataFormatString property to the BoundField value should be HTML encoded when it is displayed.

(Inherited from BoundField)
IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema

Возвращает или задает схему, связанную с этим объектом DataControlField.Gets or sets the schema associated with this DataControlField object.

(Inherited from DataControlField)
InsertVisible InsertVisible InsertVisible InsertVisible

Получает или задает значение, определяющее, находится ли объект AutoGeneratedField в режиме вставки или оно отображается.Gets or sets a value indicating whether the AutoGeneratedField object is visible in insert mode.

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
ItemStyle ItemStyle ItemStyle ItemStyle

Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием.Gets the style of any text-based content displayed by a data control field.

(Inherited from DataControlField)
NullDisplayText NullDisplayText NullDisplayText NullDisplayText

Возвращает или задает заголовок для поля, имеющего нулевое значение.Gets or sets the caption displayed for a field when the field's value is null.

(Inherited from BoundField)
ReadOnly ReadOnly ReadOnly ReadOnly

Возвращает или задает значение, позволяющее определить, можно ли менять значения поля, в режиме редактирования.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

(Inherited from BoundField)
ShowHeader ShowHeader ShowHeader ShowHeader

Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Inherited from DataControlField)
SortExpression SortExpression SortExpression SortExpression

Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных.Gets or sets a sort expression that is used by a data source control to sort data.

(Inherited from DataControlField)
SupportsHtmlEncode SupportsHtmlEncode SupportsHtmlEncode SupportsHtmlEncode

Возвращает значение, указывающее поддержку HTML кодирования объектом BoundField.Gets a value indicating whether HTML encoding is supported by a BoundField object.

(Inherited from BoundField)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод.Gets or sets a value that determines whether the control validates client input or not.

(Inherited from BoundField)
ViewState ViewState ViewState ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Inherited from DataControlField)
Visible Visible Visible Visible

Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными.Gets or sets a value indicating whether a data control field is rendered.

(Inherited from DataControlField)

Методы

CloneField() CloneField() CloneField() CloneField()

Создает точную копию текущего объекта, производного от DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Inherited from DataControlField)
CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField)

Копирует свойства текущего объекта BoundField в указанный объект DataControlField.Copies the properties of the current BoundField object to the specified DataControlField object.

(Inherited from BoundField)
CreateField() CreateField() CreateField() CreateField()

Создает пустой объект BoundField.Creates an empty BoundField object.

(Inherited from BoundField)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Заполняет указанный объект IOrderedDictionary значениями из указанного объекта DataControlFieldCell.Fills the specified IOrderedDictionary object with the values from the specified DataControlFieldCell object.

FormatDataValue(Object, Boolean) FormatDataValue(Object, Boolean) FormatDataValue(Object, Boolean) FormatDataValue(Object, Boolean)

Форматирует указанное значение поля для ячейки в объекте BoundField.Formats the specified field value for a cell in the BoundField object.

(Inherited from BoundField)
GetDesignTimeValue() GetDesignTimeValue() GetDesignTimeValue() GetDesignTimeValue()

Возвращает значение, используемое для значения поля при отрисовке объекта BoundField в конструкторе.Retrieves the value used for a field's value when rendering the BoundField object in a designer.

(Inherited from BoundField)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Control) GetValue(Control) GetValue(Control) GetValue(Control)

Извлекает значения поля, привязанного к объекту BoundField.Retrieves the value of the field bound to the BoundField object.

(Inherited from BoundField)
Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control)

Выполняет инициализацию объекта BoundField.Initializes the BoundField object.

(Inherited from BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Инициализирует указанный объект TableCell заданным состоянием строки.Initializes the specified TableCell object to the specified row state.

(Inherited from BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState) InitializeDataCell(DataControlFieldCell, DataControlRowState) InitializeDataCell(DataControlFieldCell, DataControlRowState) InitializeDataCell(DataControlFieldCell, DataControlRowState)

Инициализирует указанный объект TableCell заданным состоянием строки.Initializes the specified TableCell object to the specified row state.

(Inherited from BoundField)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Восстанавливает сохраненное раннее состояние просмотра для данного поля.Restores the previously stored view-state information for this field.

(Inherited from BoundField)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDataBindField(Object, EventArgs) OnDataBindField(Object, EventArgs) OnDataBindField(Object, EventArgs) OnDataBindField(Object, EventArgs)

Привязывает значение поля к указанному объекту BoundField.Binds the value of a field to the BoundField object.

(Inherited from BoundField)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Создает событие FieldChanged.Raises the FieldChanged event.

(Inherited from DataControlField)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
ToString() ToString() ToString() ToString()

Возврат строки, представляющей объект DataControlField.Returns a string that represents this DataControlField object.

(Inherited from DataControlField)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataControlField)
ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback()

Определяет поддержку ответов элементами управления, содержащимися в объекте AutoGeneratedField.Determines whether the controls contained in an AutoGeneratedField object support callbacks.

Явные реализации интерфейса

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления поля источника данных.Restores the data control field's previously saved view state.

(Inherited from DataControlField)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataControlField)

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

Дополнительно