DataControlFieldCollection Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет коллекцию объектов DataControlField, используемую элементами управления с привязкой к данным, например GridView и DetailsView.

public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollection

public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection

type DataControlFieldCollection = class
    inherit StateManagedCollection

Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection

Наследование: Object

StateManagedCollection
DataControlFieldCollection

Класс DataControlFieldCollection представляет коллекцию объектов, используемых DataControlField элементами управления, привязанными к данным, для указания способа представления дочерних элементов управления. Класс DataControlFieldCollection является производным от StateManagedCollectionабстрактного базового класса коллекции, используемого специально для хранения IStateManager объектов.

Объект StateManagedCollection влияет на поведение DataControlFieldCollection объекта. DataControlField Объекты, динамически добавляемые в коллекцию, будут повторно добавлены в элемент управления при восстановлении состояния. Это означает, что поле должно быть добавлено, удалено или изменено только один раз вместо каждого обратного размещения, так как большинство типов коллекций в ASP.NET требуются.

(Класс DataControlField реализует IStateManager интерфейс, который позволяет ему хранить свое состояние в ASP.NET состоянии представления. )

DataControlFieldCollection Используйте класс для программного DataControlField управления набором объектов. Обратите внимание, что чаще всего эти поля определяются декларативно.

Вы можете добавлять, вставлять и удалять DataControlField объекты с помощью соответствующих методов DataControlFieldCollection класса. Чтобы программным способом извлечь DataControlField объекты из коллекции, используйте один из следующих методов:

Используйте индексатор, чтобы получить один DataControlField объект из коллекции с помощью нотации массива.
GetEnumerator Используйте метод для создания реализуемого System.Collections.IEnumeratorобъекта, который затем можно использовать для получения элементов из коллекции.

Свойство Count задает общее количество элементов в коллекции и обычно используется для определения верхней границы коллекции. Элементы можно добавлять в коллекцию и удалять из нее с помощью Addметодов и RemoveAt ,Insert Remove.

Если вы используете GridView или DetailsView управляете, объекты, DataControlField которые создаются автоматически (например, если AutoGenerateColumns свойство ) trueне хранятся в коллекции открытых полей. Доступ к объектам, которые не создаются автоматически, и управлять ими DataControlField можно только.

В следующей таблице перечислены различные классы полей управления данными и их использование.

Класс Parameter	Описание
DataControlField	Абстрактный базовый класс для всех полей.
BoundField	Поле элемента управления с привязкой к данным, которое используется для привязки к тексту или данным, полученным из элемента управления ASP.NET источника данных.
ButtonFieldBase	Поле элемента управления с привязкой к данным, инкапсулирующее общие функции кнопки. ButtonField и CheckBoxField являются производными от него.
ButtonField	Поле элемента управления с привязкой к данным, которое отображает по крайней мере одну кнопку.
CheckBoxField	Поле элемента управления с привязкой CheckBox к данным, отображающее элемент управления.
CommandField	Поле элемента управления с привязкой к данным, которое отображает действия, которые могут выполняться с данными, отображаемыми строкой (или столбцом), такими как изменение, обновление или удаление.
HyperLinkField	Поле элемента управления с привязкой HyperLink к данным, отображающее элемент управления.
ImageField	Поле элемента управления с привязкой Image к данным, отображающее элемент управления.
TemplateField	Поле элемента управления с привязкой к данным, отображающее пользовательское содержимое в элементе управления с привязкой к данным.

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

DataControlFieldCollection()

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

Свойства

Count	Получает количество элементов, содержащихся в коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
Item[Int32]	Получает или задает объект DataControlField по указанному индексу в коллекции.

Методы

Add(DataControlField)	Добавляет указанный объект DataControlField в конец коллекции.
Clear()	Удаляет все элементы из коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
CloneFields()	Создает копию текущей коллекции.
Contains(DataControlField)	Определяет, содержит ли коллекция DataControlFieldCollection указанный объект DataControlField.
CopyTo(Array, Int32)	Копирует элементы коллекции StateManagedCollection в массив, начиная с определенного индекса в массиве. (Унаследовано от StateManagedCollection)
CopyTo(DataControlField[], Int32)	Копирует всю коллекцию DataControlFieldCollection в совместимый одномерный массив Array, начиная с указанного индекса конечного массива.
CreateKnownType(Int32)	При переопределении в производном классе создает экземпляр класса, реализующий IStateManager. Тип созданного объекта основан на указанном элементе коллекции, возвращенном методом GetKnownTypes(). (Унаследовано от StateManagedCollection)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	Возвращает итератор, осуществляющий перебор коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetKnownTypes()	При переопределении в производном классе получает массив типов IStateManager, которые может содержать коллекция StateManagedCollection. (Унаследовано от StateManagedCollection)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(DataControlField)	Определяет индекс указанного объекта DataControlField в коллекции.
Insert(Int32, DataControlField)	Вставляет указанный объект DataControlField в коллекцию DataControlFieldCollection по указанному индексу.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnClear()	При переопределении в производном классе выполняет дополнительные действия перед тем, как метод Clear() удалит все элементы из коллекции. (Унаследовано от StateManagedCollection)
OnClearComplete()	При переопределении в производном классе выполняет дополнительные действия после того, как метод Clear() завершит удаление всех элементов из коллекции. (Унаследовано от StateManagedCollection)
OnInsert(Int32, Object)	При переопределении в производном классе выполняет дополнительные действия перед тем, как метод IList.Insert(Int32, Object) или IList.Add(Object) добавит элемент в коллекцию. (Унаследовано от StateManagedCollection)
OnInsertComplete(Int32, Object)	При переопределении в производном классе выполняет дополнительные действия после того, как метод IList.Insert(Int32, Object) или IList.Add(Object) добавит элемент в коллекцию. (Унаследовано от StateManagedCollection)
OnRemove(Int32, Object)	При переопределении в производном классе выполняет дополнительные действия перед тем, как метод IList.Remove(Object) или IList.RemoveAt(Int32) удалит указанный элемент из коллекции. (Унаследовано от StateManagedCollection)
OnRemoveComplete(Int32, Object)	При переопределении в производном классе выполняет дополнительные действия после того, как метод IList.Remove(Object) или IList.RemoveAt(Int32) удалит указанный элемент из коллекции. (Унаследовано от StateManagedCollection)
OnValidate(Object)	При переопределении в производном классе проверяет элемент в коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
Remove(DataControlField)	Удаляет указанный объект DataControlField из коллекции DataControlFieldCollection.
RemoveAt(Int32)	Удаляет объект DataControlField по указанному индексу из коллекции DataControlFieldCollection.
SetDirty()	Обеспечивает принудительную сериализацию всей коллекции StateManagedCollection в состояние представления. (Унаследовано от StateManagedCollection)
SetDirtyObject(Object)	При переопределении в производном классе указывает объекту `object`, содержащемуся в коллекции, записать свое полное состояние, а не только информацию об изменениях в состоянии представления. (Унаследовано от StateManagedCollection)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

FieldsChanged

Происходит при изменении полей в коллекции, обычно в результате вызова метода Clear(), Insert(Int32, DataControlField), Remove(DataControlField) или Add(DataControlField). Это событие может также быть сгенерировано в любое время, когда DataControlField в коллекции генерирует событие FieldChanged.

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

ICollection.Count	Получает количество элементов, содержащихся в коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
ICollection.IsSynchronized	Получает значение, указывающее, является ли коллекция StateManagedCollection синхронизированной (потокобезопасной). Этот метод возвращает значение `false` во всех случаях. (Унаследовано от StateManagedCollection)
ICollection.SyncRoot	Получает объект, который можно использовать для синхронизации доступа к коллекции StateManagedCollection. Этот метод возвращает значение `null` во всех случаях. (Унаследовано от StateManagedCollection)
IEnumerable.GetEnumerator()	Возвращает итератор, осуществляющий перебор коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
IList.Add(Object)	Добавляет элемент в коллекцию StateManagedCollection. (Унаследовано от StateManagedCollection)
IList.Clear()	Удаляет все элементы из коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
IList.Contains(Object)	Определяет, содержит ли коллекция StateManagedCollection указанное значение. (Унаследовано от StateManagedCollection)
IList.IndexOf(Object)	Определяет индекс указанного элемента в коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
IList.Insert(Int32, Object)	Вставляет элемент в коллекцию StateManagedCollection по указанному индексу. (Унаследовано от StateManagedCollection)
IList.IsFixedSize	Получает значение, указывающее, имеет ли коллекция StateManagedCollection фиксированный размер. Этот метод возвращает значение `false` во всех случаях. (Унаследовано от StateManagedCollection)
IList.IsReadOnly	Получает значение, указывающее, является ли коллекция StateManagedCollection доступной только для чтения. (Унаследовано от StateManagedCollection)
IList.Item[Int32]	Возвращает элемент IStateManager по указанному индексу. (Унаследовано от StateManagedCollection)
IList.Remove(Object)	Удаляет первое вхождение указанного объекта из коллекции StateManagedCollection. (Унаследовано от StateManagedCollection)
IList.RemoveAt(Int32)	Удаляет элемент IStateManager по указанному индексу. (Унаследовано от StateManagedCollection)
IStateManager.IsTrackingViewState	Получает значение, указывающее, сохраняет ли коллекция StateManagedCollection изменения в свое состояние представления. (Унаследовано от StateManagedCollection)
IStateManager.LoadViewState(Object)	Восстанавливает сохраненное раннее состояние представления коллекции StateManagedCollection и элементов IStateManager, которые она содержит. (Унаследовано от StateManagedCollection)
IStateManager.SaveViewState()	Сохраняет изменения коллекции StateManagedCollection и каждого объекта IStateManager, который она содержит, с момента обратной передачи страницы серверу. (Унаследовано от StateManagedCollection)
IStateManager.TrackViewState()	Способствует тому, что коллекция StateManagedCollection и каждый из ее объектов IStateManager отслеживают изменения в их состоянии представления, поэтому они могут сохраняться среди запросов для той же страницы. (Унаследовано от StateManagedCollection)

Методы расширения

Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

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