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 Insert Removeметодов и RemoveAt методов.

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

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

Класс параметров	Описание
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` событие.

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)

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

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

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

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

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

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

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