DataControlFieldCollection DataControlFieldCollection DataControlFieldCollection DataControlFieldCollection Class

Определение

Представляет коллекцию объектов DataControlField, используемую элементами управления с привязкой к данным, например GridView и DetailsView.Represents a collection of DataControlField objects that are used by data-bound controls such as GridView and 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
Наследование
DataControlFieldCollectionDataControlFieldCollectionDataControlFieldCollectionDataControlFieldCollection

Комментарии

DataControlFieldCollection Класс представляетDataControlField коллекцию объектов, используемых элементами управления с привязкой к данным, чтобы указать, как представлены их дочерние элементы управления.The DataControlFieldCollection class represents a collection of DataControlField objects used by data-bound controls to specify how their child controls are presented. Класс является производным от StateManagedCollectionабстрактного базового класса коллекции, который используется специально для IStateManager хранения объектов. DataControlFieldCollectionThe DataControlFieldCollection class derives from StateManagedCollection, an abstract base collection class used specifically to store IStateManager objects.

Объект влияет на поведение DataControlFieldCollection объекта. StateManagedCollectionA StateManagedCollection object influences the behavior of a DataControlFieldCollection object. DataControlFieldобъекты, динамически добавляемые в коллекцию, будут повторно добавлены в элемент управления при восстановлении состояния.DataControlField objects that are dynamically added to the collection will be re-added to the control when state is restored. Это означает, что поле необходимо добавить, удалить или изменить только один раз вместо при каждой обратной передаче, так как для большинства типов коллекций в ASP.NET требуется.This means that a field needs to be added, removed, or changed just once instead of on each postback, as most collection types in ASP.NET require.

DataControlField ( КлассIStateManager реализует интерфейс, который позволяет сохранить свое состояние в ASP.NET состоянии представления.(The DataControlField class implements the IStateManager interface, which enables it to store its state in ASP.NET view state. ))

Используйте класс для программного управления DataControlField набором объектов. DataControlFieldCollectionUse the DataControlFieldCollection class to programmatically manage a set of DataControlField objects. Обратите внимание, что обычно эти поля определяются декларативно.Note that it is more common to define these fields declaratively.

Объекты можно добавлять, вставлять и удалять DataControlField с помощью соответствующих методов DataControlFieldCollection класса.You can add, insert, and remove DataControlField objects using the appropriate methods of the DataControlFieldCollection class. Для программного DataControlField извлечения объектов из коллекции используйте один из следующих методов.To programmatically retrieve DataControlField objects from a collection, use one of following methods:

  • Используйте индексатор для получения одного DataControlField объекта из коллекции с помощью нотации массива.Use the indexer to get a single DataControlField object from the collection using array notation.

  • Используйте метод, чтобы создать реализованный объект, который затем можно использовать для получения элементов из коллекции. System.Collections.IEnumerator GetEnumeratorUse the GetEnumerator method to create a System.Collections.IEnumerator-implemented object, which can then be used to get items from the collection.

Count Свойство задает общее число элементов в коллекции и обычно используется для определения верхней границы коллекции.The Count property specifies the total number of items in the collection, and is commonly used to determine the upper bound of the collection. Элементы коллекции можно добавлять и удалять Addс помощью методов Remove, Insert, и RemoveAt .You can add items to and remove items from the collection using the Add, Insert, Remove, and RemoveAt methods.

Если GridView используется элемент управления или DataControlField DetailsView , то объекты, создаваемые AutoGenerateColumns автоматически (например, если свойство имеет trueзначение), не сохраняются в коллекции полей с открытым доступом.If you are using the GridView or DetailsView control, the DataControlField objects that are automatically created (for example, when the AutoGenerateColumns property is true) are not stored in the publicly accessible fields collection. Вы можете получать доступ к объектам DataControlField , которые не создаются автоматически, и управлять ими.You can only access and manipulate DataControlField objects that are not automatically generated.

В следующей таблице перечислены различные классы полей элементов управления данными и их использование.The following table lists the different data control field classes and how they are used.

Класс ParameterParameter Class ОписаниеDescription
DataControlField Абстрактный базовый класс для всех полей.The abstract base class for all fields.
BoundField Привязанное к данным поле элемента управления, используемое для привязки к тексту или данным, полученным из элемента управления источника данных ASP.NET.A data-bound control field that is used to bind to text or data retrieved from an ASP.NET data source control.
ButtonFieldBase Привязанное к данным поле элемента управления, которое инкапсулирует общие функциональные возможности кнопки.A data-bound control field that encapsulates general button functionality. ButtonFieldи CheckBoxField являются производными от него.ButtonField and CheckBoxField are derived from it.
ButtonField Поле элемента управления с привязкой к данным, отображающее по крайней мере одну кнопку.A data-bound control field that displays at least one button.
CheckBoxField Поле элемента управления с привязкой к данным, CheckBox которое отображает элемент управления.A data-bound control field that displays a CheckBox control.
CommandField Привязанное к данным поле элемента управления, которое отображает действия, которые могут быть выполнены с данными, отображаемыми строкой (или столбцом), например Правка, обновление или удаление.A data-bound control field that displays actions that can be performed on the data displayed by the row (or column), such as edit, update, or delete.
HyperLinkField Поле элемента управления с привязкой к данным, HyperLink которое отображает элемент управления.A data-bound control field that displays a HyperLink control.
ImageField Поле элемента управления с привязкой к данным, Image которое отображает элемент управления.A data-bound control field that displays an Image control.
TemplateField Поле элемента управления с привязкой к данным, которое отображает пользовательское содержимое в элементе управления с привязкой к данным.A data-bound control field that displays custom content in a data-bound control.

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

DataControlFieldCollection() DataControlFieldCollection() DataControlFieldCollection() DataControlFieldCollection()

Инициализирует новый экземпляр класса DataControlFieldCollection.Initializes a new instance of the DataControlFieldCollection class.

Свойства

Count Count Count Count

Получает количество элементов, содержащихся в коллекции StateManagedCollection.Gets the number of elements contained in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Получает количество элементов, содержащихся в коллекции StateManagedCollection.Gets the number of elements contained in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Получает значение, указывающее, является ли коллекция StateManagedCollection синхронизированной (потокобезопасной).Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). Этот метод возвращает значение false во всех случаях.This method returns false in all cases.

(Inherited from StateManagedCollection)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Получает объект, который можно использовать для синхронизации доступа к коллекции StateManagedCollection .Gets an object that can be used to synchronize access to the StateManagedCollection collection. Этот метод возвращает значение null во всех случаях.This method returns null in all cases.

(Inherited from StateManagedCollection)
IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Получает значение, указывающее, имеет ли коллекция StateManagedCollection фиксированный размер.Gets a value indicating whether the StateManagedCollection collection has a fixed size. Этот метод возвращает значение false во всех случаях.This method returns false in all cases.

(Inherited from StateManagedCollection)
IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Получает значение, указывающее, является ли коллекция StateManagedCollection доступной только для чтения.Gets a value indicating whether the StateManagedCollection collection is read-only.

(Inherited from StateManagedCollection)
IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Получает элемент IStateManager с указанным индексом.Gets the IStateManager element at the specified index.

(Inherited from StateManagedCollection)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

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

(Inherited from StateManagedCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Получает или задает объект DataControlField по указанному индексу в коллекции.Gets or sets the DataControlField object at the specified index in the collection.

Методы

Add(DataControlField) Add(DataControlField) Add(DataControlField) Add(DataControlField)

Добавляет указанный объект DataControlField в конец коллекции.Appends the specified DataControlField object to the end of the collection.

Clear() Clear() Clear() Clear()

Удаляет все элементы из коллекции StateManagedCollection.Removes all items from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
CloneFields() CloneFields() CloneFields() CloneFields()

Создает копию текущей коллекции.Creates a copy of the current collection.

Contains(DataControlField) Contains(DataControlField) Contains(DataControlField) Contains(DataControlField)

Определяет, содержит ли коллекция DataControlFieldCollection указанный объект DataControlField.Determines whether the DataControlFieldCollection collection contains a specific DataControlField object.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Копирует элементы коллекции StateManagedCollection в массив, начиная с определенного индекса в массиве.Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index.

(Inherited from StateManagedCollection)
CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32)

Копирует всю коллекцию DataControlFieldCollection в совместимый одномерный массив Array, начиная с указанного индекса конечного массива.Copies the entire DataControlFieldCollection collection to a compatible one-dimensional Array, starting at the specified index of the target array.

CreateKnownType(Int32) CreateKnownType(Int32) CreateKnownType(Int32) CreateKnownType(Int32)

При переопределении в производном классе создает экземпляр класса, реализующий IStateManager.When overridden in a derived class, creates an instance of a class that implements IStateManager. Тип созданного объекта основан на указанном элементе коллекции, возвращенном методом GetKnownTypes().The type of object created is based on the specified member of the collection returned by the GetKnownTypes() method.

(Inherited from StateManagedCollection)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Возвращает итератор, осуществляющий перебор коллекции StateManagedCollection.Returns an iterator that iterates through the StateManagedCollection collection.

(Inherited from StateManagedCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetKnownTypes() GetKnownTypes() GetKnownTypes() GetKnownTypes()

При переопределении в производном классе получает массив типов IStateManager, которые может содержать коллекция StateManagedCollection.When overridden in a derived class, gets an array of IStateManager types that the StateManagedCollection collection can contain.

(Inherited from StateManagedCollection)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(DataControlField) IndexOf(DataControlField) IndexOf(DataControlField) IndexOf(DataControlField)

Определяет индекс указанного объекта DataControlField в коллекции.Determines the index of a specific DataControlField object in the collection.

Insert(Int32, DataControlField) Insert(Int32, DataControlField) Insert(Int32, DataControlField) Insert(Int32, DataControlField)

Вставляет указанный объект DataControlField в коллекцию DataControlFieldCollection по указанному индексу.Inserts the specified DataControlField object into the DataControlFieldCollection collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnClear() OnClear() OnClear() OnClear()

При переопределении в производном классе выполняет дополнительные действия перед тем, как метод Clear() удалит все элементы из коллекции.When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection.

(Inherited from StateManagedCollection)
OnClearComplete() OnClearComplete() OnClearComplete() OnClearComplete()

При переопределении в производном классе выполняет дополнительные действия после того, как метод Clear() завершит удаление всех элементов из коллекции.When overridden in a derived class, performs additional work after the Clear() method finishes removing all items from the collection.

(Inherited from StateManagedCollection)
OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object)

При переопределении в производном классе выполняет дополнительные действия перед тем, как метод IList.Insert(Int32, Object) или IList.Add(Object) добавит элемент в коллекцию.When overridden in a derived class, performs additional work before the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Inherited from StateManagedCollection)
OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object)

При переопределении в производном классе выполняет дополнительные действия после того, как метод IList.Insert(Int32, Object) или IList.Add(Object) добавит элемент в коллекцию.When overridden in a derived class, performs additional work after the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Inherited from StateManagedCollection)
OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object)

При переопределении в производном классе выполняет дополнительные действия перед тем, как метод IList.Remove(Object) или IList.RemoveAt(Int32) удалит указанный элемент из коллекции.When overridden in a derived class, performs additional work before the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Inherited from StateManagedCollection)
OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object)

При переопределении в производном классе выполняет дополнительные действия после того, как метод IList.Remove(Object) или IList.RemoveAt(Int32) удалит указанный элемент из коллекции.When overridden in a derived class, performs additional work after the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Inherited from StateManagedCollection)
OnValidate(Object) OnValidate(Object) OnValidate(Object) OnValidate(Object)

При переопределении в производном классе проверяет элемент в коллекции StateManagedCollection.When overridden in a derived class, validates an element of the StateManagedCollection collection.

(Inherited from StateManagedCollection)
Remove(DataControlField) Remove(DataControlField) Remove(DataControlField) Remove(DataControlField)

Удаляет указанный объект DataControlField из коллекции DataControlFieldCollection.Removes the specified DataControlField object from the DataControlFieldCollection collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Удаляет объект DataControlField по указанному индексу из коллекции DataControlFieldCollection.Removes the DataControlField object at the specified index from the DataControlFieldCollection collection.

SetDirty() SetDirty() SetDirty() SetDirty()

Обеспечивает принудительную сериализацию всей коллекции StateManagedCollection в состояние представления.Forces the entire StateManagedCollection collection to be serialized into view state.

(Inherited from StateManagedCollection)
SetDirtyObject(Object) SetDirtyObject(Object) SetDirtyObject(Object) SetDirtyObject(Object)

При переопределении в производном классе указывает объекту object, содержащемуся в коллекции, записать свое полное состояние, а не только информацию об изменениях в состоянии представления.When overridden in a derived class, instructs an object contained by the collection to record its entire state to view state, rather than recording only change information.

(Inherited from StateManagedCollection)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

События

FieldsChanged FieldsChanged FieldsChanged FieldsChanged

Происходит при изменении полей в коллекции, обычно в результате вызова метода Clear(), Insert(Int32, DataControlField), Remove(DataControlField) или Add(DataControlField).Occurs when the fields in the collection change, usually as the result of a Clear(), Insert(Int32, DataControlField), Remove(DataControlField) or Add(DataControlField) method call. Это событие может также быть сгенерировано в любое время, когда DataControlField в коллекции генерирует событие FieldChanged.This event is also raised anytime a DataControlField in the collection raises its FieldChanged event.

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

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Возвращает итератор, осуществляющий перебор коллекции StateManagedCollection.Returns an iterator that iterates through the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Добавляет элемент в коллекцию StateManagedCollection.Adds an item to the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Удаляет все элементы из коллекции StateManagedCollection.Removes all items from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Определяет, содержит ли коллекция StateManagedCollection указанное значение.Determines whether the StateManagedCollection collection contains a specific value.

(Inherited from StateManagedCollection)
IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Определяет индекс указанного элемента в коллекции StateManagedCollection.Determines the index of a specified item in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Вставляет элемент в коллекцию StateManagedCollection по указанному индексу.Inserts an item into the StateManagedCollection collection at the specified index.

(Inherited from StateManagedCollection)
IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Удаляет первое вхождение указанного объекта из коллекции StateManagedCollection.Removes the first occurrence of the specified object from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Удаляет элемент IStateManager по указанному индексу.Removes the IStateManager element at the specified index.

(Inherited from StateManagedCollection)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления коллекции StateManagedCollection и элементов IStateManager, которые она содержит.Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains.

(Inherited from StateManagedCollection)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Сохраняет изменения коллекции StateManagedCollection и каждого объекта IStateManager, который она содержит, с момента обратной передачи страницы серверу.Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server.

(Inherited from StateManagedCollection)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Способствует тому, что коллекция StateManagedCollection и каждый из ее объектов IStateManager отслеживают изменения в их состоянии представления, поэтому они могут сохраняться среди запросов для той же страницы.Causes the StateManagedCollection collection and each of the IStateManager objects it contains to track changes to their view state so they can be persisted across requests for the same page.

(Inherited from StateManagedCollection)

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

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

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

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