Эта статья переведена вручную. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. |
Перевод
Текст оригинала
|
GridView - класс
Отображает значения источника данных в таблице, где каждый столбец представляет поле, а каждая строка — запись. Элемент управления GridView позволяет выбирать, сортировать и изменять эти записи.
Сборка: System.Web (в System.Web.dll)
Тип GridView предоставляет следующие члены.
| Имя | Описание | |
|---|---|---|
|
AccessKey | Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl.) |
|
Adapter | Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control.) |
|
AllowPaging | Возвращает или задает значение, определяющее, доступна ли возможность разбиения по страницам. |
|
AllowSorting | Возвращает или задает значение, определяющее, доступна ли возможность сортировки. |
|
AlternatingRowStyle | Возвращает ссылку на объект TableItemStyle, позволяющий изменять вид изменяющихся строк данных в элементе управления GridView. |
|
AppRelativeTemplateSourceDirectory | Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control.) |
|
Attributes | Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl.) |
|
AutoGenerateColumns | Возвращает или задает значение, показывающее, будут ли граничные поля автоматически созданы для каждого поля источника данных. |
|
AutoGenerateDeleteButton | Возвращает или задает значение, указывающее, добавляется ли поле столбца CommandField с кнопкой "Удалить" для каждой строки данных автоматически в элемент управления GridView. |
|
AutoGenerateEditButton | Возвращает или задает значение, указывающее, следует ли автоматически добавлять поле столбца CommandField с кнопкой "Править" для каждой строки данных в элементе управления GridView. |
|
AutoGenerateSelectButton | Возвращает или задает значение, указывающее на необходимость добавления поля столбца CommandField с кнопкой "Выбрать" для каждой строки данный, автоматически добавленной в элемент управления GridView. |
|
BackColor | Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
BackImageUrl | Возвращает или задает URL-адрес изображения, отображаемого как фон элемента управления GridView. |
|
BindingContainer | Инфраструктура. Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control.) |
|
BorderColor | Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl.) |
|
BorderStyle | Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
BorderWidth | Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
BottomPagerRow | Возвращает объект GridViewRow, представляющий нижнюю строку страницы в элементе управления GridView. |
|
Caption | Возвращает или задает текст для отображения в HTML-заголовке элемента в элементе управления GridView. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. |
|
CaptionAlign | Возвращает или задает горизонтальное или вертикальное расположение элемента HTML-заголовка в элементе управления GridView. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. |
|
CellPadding | Получает или задает расстояние между содержимым ячейки и ее границей. |
|
CellSpacing | Возвращает или задает расстояние между ячейками. |
|
ChildControlsCreated | Возвращает значение, которое указывает, создан ли дочерний элемент управления серверного элемента управления. (Унаследовано от Control.) |
|
ClientID | Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control.) |
|
ClientIDMode | Получает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control.) |
|
ClientIDRowSuffix | Получает или задает имена полей данных, значения которых добавляются к значению свойства ClientID для однозначной идентификации каждого экземпляра элемента управления с привязкой к данным. |
|
ClientIDRowSuffixDataKeys | Инфраструктура. Получает значения данных, используемые для однозначной идентификации каждого экземпляра элемента управления с привязкой к данным при формировании платформой ASP.NET значения ClientID. |
|
ClientIDSeparator | Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control.) |
|
Columns | Возвращает коллекцию объектов DataControlField, предоставляющих поля столбцов элемента управления GridView. |
|
ColumnsGenerator | Возвращает или задает элемент управления, который автоматически сгенерирует столбцы для элемента управления GridView, использующего функции платформы динамических данных ASP.NET. |
|
Context | Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control.) |
|
Controls | Возвращает коллекцию дочерних элементов управления из составного элемента управления с привязкой к данным. (Унаследовано от CompositeDataBoundControl.) |
|
ControlStyle | Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl.) |
|
ControlStyleCreated | Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl.) |
|
CssClass | Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl.) |
|
DataItemContainer | Получает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control.) |
|
DataKeyNames | Возвращает или задает массив, содержащий имена первичных ключевых полей для элементов, отображенных в элементе управления GridView. |
|
DataKeys | Возвращает коллекцию объектов DataKey, представляющих ключевое значение данных каждой строки в элементу управления GridView. |
|
DataKeysContainer | Получает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control.) |
|
DataMember | Возвращает или задает имя списка данных, к которому выполняется привязка элемента управления с привязкой к данным, в случае наличия в источнике данных нескольких отдельных списков элементов данных. (Унаследовано от DataBoundControl.) |
|
DataSource | Получает или задает объект, из которого элемент управления, присоединенный к данным, извлекает свои данные. (Унаследовано от BaseDataBoundControl.) |
|
DataSourceID | Получает или задает ID элемента управления, из которого элемент управления, присоединенный к данным, извлекает свои данные. (Унаследовано от DataBoundControl.) |
|
DataSourceObject | Возвращает объект, реализующий интерфейс IDataSource, который предоставляет доступ к содержимому данных объекта. (Унаследовано от DataBoundControl.) |
|
DesignMode | Возвращает значение, определяющее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control.) |
|
EditIndex | Возвращает или задает индекс строки для правки. |
|
EditRowStyle | Возвращает ссылку на объект TableItemStyle, позволяющую управлять видом строки, выбранной для правки в элементе управления GridView. |
|
EmptyDataRowStyle | Возвращает ссылку на объект TableItemStyle, позволяющий управлять видом отображаемой пустой строки, когда элемент управления GridView привязан к источнику данных, не содержащему записей. |
|
EmptyDataTemplate | Возвращает или задает определенное пользователем содержимое для пустой строки данных, когда элемент управления GridView привязан к источнику данных, не имеющему записей. |
|
EmptyDataText | Возвращает или задает текст для отображения в пустой строке данных, когда элемент управления GridView привязан к источнику данных, не имеющему записей. |
|
Enabled | Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl.) |
|
EnableModelValidation | Получает или задает значение, указывающее, будет ли проверяющий элемент управления обрабатывать исключения, происходящие во время операций вставки или обновления. |
|
EnablePersistedSelection | Получает или задает значение, указывающее, на чем основан выбор строки: на значениях индекса или значениях ключей данных. |
|
EnableSortingAndPagingCallbacks | Возвращает или задает значение, указывающее на использование клиентских ответов при операциях сортировки и разбиения по страницам. |
|
EnableTheming | Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl.) |
|
EnableViewState | Получает или задает значение, определяющее сохранение состояния просмотра серверного элемента управления и содержащихся в нем дочерних элементов управления для клиента, создающего запрос. (Унаследовано от Control.) |
|
Events | Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control.) |
|
Font | Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl.) |
|
FooterRow | Возвращает объект GridViewRow, представляющий строку нижнего колонтитула в элементе управления GridView. |
|
FooterStyle | Возвращает ссылку на объект TableItemStyle, позволяющий управлять видом строки нижнего колонтитула в элементе управления GridView. |
|
ForeColor | Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
GridLines | Возвращает или задает стиль линии сетки для элемента управления GridView. |
|
HasAttributes | Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl.) |
|
HasChildViewState | Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control.) |
|
HeaderRow | Возвращает объект GridViewRow, представляющий строку верхнего колонтитула в элементе управления GridView. |
|
HeaderStyle | Возвращает ссылку на объект TableItemStyle, позволяющий управлять видом строки верхнего колонтитула в элементе управления GridView. |
|
Height | Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
HorizontalAlign | Возвращает или задает горизонтальное выравнивание элемента управления GridView на странице. |
|
ID | Получает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control.) |
|
IdSeparator | Инфраструктура. Возвращает символ, использованный для разделения идентификаторов элементов управления. (Унаследовано от Control.) |
|
Initialized | Получает значение, указывающее, был ли проинициализирован элемент управления, присоединенный к данным. (Унаследовано от BaseDataBoundControl.) |
|
IsBoundUsingDataSourceID | Получает значение, указывающее, задано ли значение свойства DataSourceID. (Унаследовано от BaseDataBoundControl.) |
|
IsChildControlStateCleared | Возвращает значение, которое указывает, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control.) |
|
IsEnabled | Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl.) |
|
IsTrackingViewState | Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control.) |
|
IsViewStateEnabled | Возвращает значение, показывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control.) |
|
LoadViewStateByID | Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control.) |
|
NamingContainer | Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства Control.ID. (Унаследовано от Control.) |
|
Page | Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control.) |
|
PageCount | Возвращает общее число страниц, необходимых для отображения записей источника данных в элементе управления GridView. |
|
PageIndex | Получает или задает индекс отображаемой в настоящее время страницы. |
|
PagerSettings | Возвращает ссылку на объект PagerSettings, позволяющий управлять свойствами кнопками строки страницы в элементе управления GridView. |
|
PagerStyle | Возвращает ссылку на объект TableItemStyle, позволяющий управлять видом строки страницы в элементе управления GridView. |
|
PagerTemplate | Возвращает или задает содержимое для строки страницы элемента управления GridView. |
|
PageSize | Возвращает или задает число записей, отображаемых на странице элемента управления GridView. |
|
Parent | Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control.) |
|
RenderingCompatibility | Получает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control.) |
|
RequiresDataBinding | Получает или задает значение, указывающее, должен ли вызываться метод DataBind. (Унаследовано от BaseDataBoundControl.) |
|
RowHeaderColumn | Возвращает или задает имя столбца, который следует использовать в качестве верхнего колонтитула элемента управления GridView. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. |
|
Rows | Возвращает коллекцию объектов GridViewRow, предоставляющих строки данных элемента управления GridView. |
|
RowStyle | Возвращает ссылку на объект TableItemStyle, позволяющий управлять видом строк данных в элементе управления GridView. |
|
SelectArguments | Возвращает объект DataSourceSelectArguments который используется элементом управления с привязкой к данным при извлечении данных из их источника. (Унаследовано от DataBoundControl.) |
|
SelectedDataKey | Возвращает объект DataKey, содержащий значения ключа данных для выбранной строки в элементе управления GridView. |
|
SelectedIndex | Возвращает или задает индекс выбранной строки элемента управления GridView. |
|
SelectedPersistedDataKey | Получает или задает значение ключа данных для сохраненного выбранного элемента в элементе управления GridView. |
|
SelectedRow | Возвращает ссылку на объект GridViewRow, представляющий выбранную строку в элементе управления. |
|
SelectedRowStyle | Возвращает ссылку на объект TableItemStyle, позволяющий настроить вид выделенной строки в элементе управления GridView. |
|
SelectedValue | Возвращает значения ключа данных выбранной строки элемента управления GridView. |
|
ShowFooter | Возвращает или задает значение, определяющее, отображается ли нижний колонтитул в элементе управления GridView. |
|
ShowHeader | Возвращает или задает значение, определяющее, отображается ли строка верхнего колонтитула в элементе управления GridView. |
|
ShowHeaderWhenEmpty | Получает или задает значение, указывающее, видим ли заголовок столбца в элементе управления GridView, когда столбец не содержит данных. |
|
Site | Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control.) |
|
SkinID | Получает или задает обложку, применимую к элементу управления. (Унаследовано от WebControl.) |
|
SortDirection | Возвращает направление сортировки сортируемого столбца. |
|
SortedAscendingCellStyle | Получает или задает стиль CSS для столбца элемента управления GridView, когда столбец отсортирован по возрастанию. |
|
SortedAscendingHeaderStyle | Получает или задает стиль CSS, применяемый к заголовку столбца элемента управления GridView, когда столбец отсортирован по возрастанию. |
|
SortedDescendingCellStyle | Получает или задает стиль столбца элемента управления GridView, когда столбец отсортирован по убыванию. |
|
SortedDescendingHeaderStyle | Получает или задает стиль, применяемый к заголовку столбца элемента управления GridView, когда столбец отсортирован по убыванию. |
|
SortExpression | Возвращает выражение сортировки, связанное с сортируемым столбцом или столбцами. |
|
Style | Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
SupportsDisabledAttribute | Получает значение, указывающее, должен ли элемент управления устанавливать атрибут disabled отображаемого элемента HTML в значение "disabled", если для свойства элемента управления IsEnabled задано значение false. (Унаследовано от BaseDataBoundControl.) |
|
TabIndex | Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl.) |
|
TagKey | Возвращает значение HtmlTextWriterTag для элемента управления GridView. (Переопределяет WebControl.TagKey.) |
|
TagName | Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl.) |
|
TemplateControl | Возвращает или устанавливает ссылку на шаблон, содержащий элемент управления. (Унаследовано от Control.) |
|
TemplateSourceDirectory | Возвращает виртуальную папку Page или UserControl, содержащую текущий серверный элемент управления. (Унаследовано от Control.) |
|
ToolTip | Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl.) |
|
TopPagerRow | Возвращает объект GridViewRow, представляющий верхнюю строку страницы в элементе управления GridView. |
|
UniqueID | Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control.) |
|
UseAccessibleHeader | Возвращает или задает значение, указывающее на передачу в доступном формате верхнего колонтитула, элементом управления GridView. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. |
|
ViewState | Получает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control.) |
|
ViewStateIgnoresCase | Возвращает значение, определяющее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control.) |
|
ViewStateMode | Получает или задает режим состояния представления данного элемента управления. (Унаследовано от Control.) |
|
Visible | Возвращает или устанавливает значение, определяющее, преобразован ли серверный элемент управления в пользовательский интерфейс на странице. (Унаследовано от Control.) |
|
Width | Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl.) |
| Имя | Описание | |
|---|---|---|
|
AddAttributesToRender | Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.) |
|
AddedControl | Вызывается после того, как дочерний элемент управления добавлен в коллекцию Controls объекта Control. (Унаследовано от Control.) |
|
AddParsedSubObject | Сообщает серверному элементу управления, что XML или HTML элемент был проанализирован, и добавляет элемент в объект ControlCollection серверного элемента управления. (Унаследовано от Control.) |
|
ApplyStyle | Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl.) |
|
ApplyStyleSheetSkin | Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control.) |
|
BuildProfileTree | Инфраструктура. Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control.) |
|
ClearCachedClientID | Инфраструктура. Задает для кэшированного свойства ClientID значение Nothing. (Унаследовано от Control.) |
|
ClearChildControlState | Удаляет сведения состояния элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control.) |
|
ClearChildState | Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control.) |
|
ClearChildViewState | Удаляет сведения о состояния представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control.) |
|
ClearEffectiveClientIDMode | Инфраструктура. Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control.) |
|
ConfirmInitState | Устанавливает исходное состояние элемента управления, присоединенного к данным. (Унаследовано от BaseDataBoundControl.) |
|
CopyBaseAttributes | Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.) |
|
CreateAutoGeneratedColumn | Создает автоматически создаваемое поле столбца. |
|
CreateChildControls | Инфраструктура. Создает иерархию элементов управления, используемую для вывода составного элемента управления с привязкой к данным на основе значений, которые хранятся в состоянии представления. (Унаследовано от CompositeDataBoundControl.) |
|
CreateChildControls(IEnumerable, Boolean) | Инфраструктура. Создает иерархию элементов управления для передачи элемента управления GridView с использованием указанного источника данных. (Переопределяет CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean).) |
|
CreateChildTable | Инфраструктура. Создает новую дочернюю таблицу. |
|
CreateColumns | Создает набор полей столбца, реализующихся для построения иерархии элементов управления. |
|
CreateControlCollection | Создает новый объект ControlCollection для хранения дочерних элементов (текстовых и серверных) серверного элемента управления. (Унаследовано от Control.) |
|
CreateControlStyle | Инфраструктура. Создает стиль, используемый по умолчанию для элемента управления. (Переопределяет WebControl.CreateControlStyle.) |
|
CreateDataSourceSelectArguments | Создает объект DataSourceSelectArguments, содержащий аргументы для передачи в источник данных для обработки. (Переопределяет DataBoundControl.CreateDataSourceSelectArguments.) |
|
CreateRow | Создает строку в элементе управления GridView. |
|
DataBind | Привязывает источник данных к элементу управления GridView. Этот метод не может наследоваться. (Переопределяет BaseDataBoundControl.DataBind.) |
|
DataBind(Boolean) | Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control.) |
|
DataBindChildren | Привязывает источник данных к дочерним элементам серверного элемента управления. (Унаследовано от Control.) |
|
DeleteRow | Удаляет из источника данных запись по указанному индексу. |
|
Dispose | Подключает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control.) |
|
EnsureChildControls | Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control.) |
|
EnsureDataBound | Вызывает метод DataBind, если установлено свойство DataSourceID и элемент управления, присоединенный к данным, помечен, как требующий привязки. (Унаследовано от BaseDataBoundControl.) |
|
EnsureID | Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control.) |
|
Equals(Object) | Определяет, равен ли заданный объект Object текущему объекту Object. (Унаследовано от Object.) |
|
ExtractRowValues | Получает значения каждого из полей, объявленных в указанной строке, и сохраняет их в указанном объекте IOrderedDictionary. |
|
Finalize | Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.) |
|
FindControl(String) | Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования. (Унаследовано от Control.) |
|
FindControl(String, Int32) | Инфраструктура. Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Можно не переопределять эту версию метода FindControl. (Унаследовано от Control.) |
|
Focus | Задает фокус ввода элемента управления. (Унаследовано от Control.) |
|
GetCallbackResult | Возвращает результат события обратного вызова, предназначенного для элемента управления. |
|
GetCallbackScript | Создает скрипт ответа для кнопки, выполняющей операцию сортировки. |
|
GetData | Извлекает объект DataSourceView, используемый элементом управления с привязкой к данным для выполнения операций с данными. (Унаследовано от DataBoundControl.) |
|
GetDataSource | Извлекает интерфейс IDataSource, с которым связан элемент управления с привязкой к данным, если таковой существует. (Унаследовано от DataBoundControl.) |
|
GetDesignModeState | Инфраструктура. Возвращает данные времени разработки для элемента управления. (Унаследовано от Control.) |
|
GetHashCode | Играет роль хэш-функции для определенного типа. (Унаследовано от Object.) |
|
GetRouteUrl(Object) | Получает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control.) |
|
GetRouteUrl(RouteValueDictionary) | Получает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control.) |
|
GetRouteUrl(String, Object) | Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control.) |
|
GetRouteUrl(String, RouteValueDictionary) | Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control.) |
|
GetType | Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.) |
|
GetUniqueIDRelativeTo | Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control.) |
|
HasControls | Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control.) |
|
HasEvents | Возвращает значение, определяющее, будут ли регистрироваться события для элемента управления или каких либо дочерних элементов управления. (Унаследовано от Control.) |
|
InitializePager | Инициализирует строку страницы, отображаемую при включенном разбиении по страницам. |
|
InitializeRow | Инициализирует строку в элементе управления GridView. |
|
IsBindableType | Определяет возможность привязки указанного типа данных к столбцу элемента управления GridView. |
|
IsLiteralContent | Инфраструктура. Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control.) |
|
LoadControlState | Инфраструктура. Загружает состояние свойств элемента управления GridView, которые следует применить даже если свойство Control.EnableViewState имеет значение false. (Переопределяет Control.LoadControlState(Object).) |
|
LoadViewState | Загружает предварительно сохраненное состояние представления для элемента управления GridView. (Переопределяет WebControl.LoadViewState(Object).) |
|
MapPathSecure | Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control.) |
|
MarkAsDataBound | Задает в данных о состоянии представления состояние элемента управления, соответствующее успешной привязке к данным. (Унаследовано от DataBoundControl.) |
|
MemberwiseClone | Создает неполную копию текущего объекта Object. (Унаследовано от Object.) |
|
MergeStyle | Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.) |
|
OnBubbleEvent | Определяет, передается ли событие серверного веб-элемента управления вверх в иерархии серверных элементов управления пользовательского интерфейса страницы. (Переопределяет Control.OnBubbleEvent(Object, EventArgs).) |
|
OnDataBinding | Вызывает событие DataBinding. (Унаследовано от Control.) |
|
OnDataBound | Генерирует событие DataBound. (Унаследовано от BaseDataBoundControl.) |
|
OnDataPropertyChanged | Осуществляет перепривязки элемента управления GridView к его данных после изменения свойства DataMember, DataSource или DataSourceID. (Переопределяет DataBoundControl.OnDataPropertyChanged.) |
|
OnDataSourceViewChanged | Вызывает событие DataSourceViewChanged. (Переопределяет DataBoundControl.OnDataSourceViewChanged(Object, EventArgs).) |
|
OnInit | Генерирует событие Control.Init. (Переопределяет BaseDataBoundControl.OnInit(EventArgs).) |
|
OnLoad | Обрабатывает событие Control.Load. (Унаследовано от DataBoundControl.) |
|
OnPageIndexChanged | Генерирует событие PageIndexChanged. |
|
OnPageIndexChanging | Генерирует событие PageIndexChanging. |
|
OnPagePreLoad | Устанавливает исходное состояние элемента управления, привязанного к данным, перед его загрузкой. (Переопределяет DataBoundControl.OnPagePreLoad(Object, EventArgs).) |
|
OnPreRender | Инфраструктура. Вызывает событие PreRender. (Переопределяет BaseDataBoundControl.OnPreRender(EventArgs).) |
|
OnRowCancelingEdit | Генерирует событие RowCancelingEdit. |
|
OnRowCommand | Генерирует событие RowCommand. |
|
OnRowCreated | Порождает событие RowCreated. |
|
OnRowDataBound | Порождает событие RowDataBound. |
|
OnRowDeleted | Генерирует событие RowDeleted. |
|
OnRowDeleting | Генерирует событие RowDeleting. |
|
OnRowEditing | Генерирует событие RowEditing. |
|
OnRowUpdated | Генерирует событие RowUpdated. |
|
OnRowUpdating | Генерирует событие RowUpdating. |
|
OnSelectedIndexChanged | Генерирует событие SelectedIndexChanged. |
|
OnSelectedIndexChanging | Порождает событие SelectedIndexChanging. |
|
OnSorted | Генерирует событие Sorted. |
|
OnSorting | Генерирует событие Sorting. |
|
OnUnload | Вызывает событие Unload. (Унаследовано от Control.) |
|
OpenFile | Возвращает Stream, используемое для чтения файла. (Унаследовано от Control.) |
|
PerformDataBinding | Инфраструктура. Привязывает указанный источник данных к элементу управления GridView. (Переопределяет CompositeDataBoundControl.PerformDataBinding(IEnumerable).) |
|
PerformSelect | Извлекает данные из соответствующего источника данных. (Унаследовано от DataBoundControl.) |
|
PrepareControlHierarchy | Инфраструктура. Создает иерархию элементов управления. |
|
RaiseBubbleEvent | Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control.) |
|
RaiseCallbackEvent | Создает аргументы для обработчика ответов в методе GetCallbackEventReference. |
|
RaisePostBackEvent | Генерирует соответствующее событие для элемента управления GridView, когда он выполняет обратную передачу серверу. |
|
RemovedControl | Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control.) |
|
Render | Инфраструктура. Преобразовывает для просмотра содержимое серверного веб-элемента управления заданного в объекте System.Web.UI.HtmlTextWriter. (Переопределяет WebControl.Render(HtmlTextWriter).) |
|
RenderBeginTag | Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.) |
|
RenderChildren | Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента. (Унаследовано от Control.) |
|
RenderContents | Выводит содержимое элемента управления в заданный модуль записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.) |
|
RenderControl(HtmlTextWriter) | Выводит содержимое серверного элемента управления в предоставленный объект HtmlTextWriter и сохраняет сведения трассировки элемента управления, если трассировка включена. (Унаследовано от Control.) |
|
RenderControl(HtmlTextWriter, ControlAdapter) | Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control.) |
|
RenderEndTag | Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.) |
|
ResolveAdapter | Возвращает адаптер элемента управления, отвечающий за визуализацию определенного элемента управления. (Унаследовано от Control.) |
|
ResolveClientUrl | Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control.) |
|
ResolveUrl | Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control.) |
|
SaveControlState | Инфраструктура. Сохраняет состояние свойств в элементе управления GridView, которое необходимо сохранить, даже если свойство Control.EnableViewState получает значение false. (Переопределяет Control.SaveControlState.) |
|
SaveViewState | Инфраструктура. Загружает предварительно сохраненное состояние представления для элемента управления GridView. (Переопределяет WebControl.SaveViewState.) |
|
SelectRow | Выбирает строку для редактирования в элементе управления GridView. |
|
SetDesignModeState | Задает данные времени разработки для элемента управления. (Унаследовано от Control.) |
|
SetEditRow | Устанавливает для строки режим правки в элементе управления GridView с использованием заданного индекса строки. |
|
SetPageIndex | Задает индекс страницы элемента управления GridView с использованием индекса строки. |
|
SetRenderMethodDelegate | Инфраструктура. Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого в родительский элемент управления. (Унаследовано от Control.) |
|
Sort | Сортирует элемент управления GridView в соответствии с указанным выражением сортировки и направлением. |
|
ToString | Возвращение строки, представляющей текущий объект. (Унаследовано от Object.) |
|
TrackViewState | Инфраструктура. Отслеживает изменения состояния представления элемента управления GridView для сохранения в объекте элемента управления System.Web.UI.StateBag. Этот объект доступен с помощью свойства Control.ViewState. (Переопределяет WebControl.TrackViewState.) |
|
UpdateRow | Обновляет запись по указанному индексу строки, используя значения поля строки. |
|
ValidateDataSource | Проверяет, может ли элемент управления с привязкой к данным, привязываемый к объекту, работать с этим объектом. (Унаследовано от DataBoundControl.) |
| Имя | Описание | |
|---|---|---|
|
DataBinding | Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control.) |
|
DataBound | Происходит после привязки серверного элемента управления к источнику данных. (Унаследовано от BaseDataBoundControl.) |
|
Disposed | Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control.) |
|
Init | Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control.) |
|
Load | Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control.) |
|
PageIndexChanged | Происходит при щелчке кнопки страницы, но после обработки операции разбиения по страницам элементом управления GridView. |
|
PageIndexChanging | Происходит при щелчке кнопки страницы, но перед обработкой операции разбиения по страницам элементом управления GridView. |
|
PreRender | Происходит после загрузки объекта Control, но перед визуализацией. (Унаследовано от Control.) |
|
RowCancelingEdit | Происходит при щелчке кнопки "Отменить" в строке в режиме правки, но до выхода строки из режима правки. |
|
RowCommand | Происходит при щелчке по кнопке с помощью элемента управления GridView. |
|
RowCreated | Происходит при создании строки в элементе управления GridView. |
|
RowDataBound | Происходит при привязке строки данных к данным в элементе управления GridView. |
|
RowDeleted | Происходит при щелчке по кнопке "Удалить" в строке, но после удаление строки элементом управления GridView. |
|
RowDeleting | Происходит при щелчке кнопки "Удалить" в строке, до удаления строки элементом управления GridView. |
|
RowEditing | Происходит при щелчке по кнопке "Править" в строке, но до входа элемента управления в режим правки GridView. |
|
RowUpdated | Происходит при щелчке по кнопке "Обновить" в строке, но после обновления строки элементом управления GridView. |
|
RowUpdating | Происходит при щелчке по кнопке "Обновить" в строке, но до обновления строки элементом управления GridView. |
|
SelectedIndexChanged | Происходит при щелчке по кнопке строки "Выбрать", но после обработки операции выбора элементом управления GridView. |
|
SelectedIndexChanging | Происходит при щелчке по кнопке строки "Выбрать", но до обработки операции выбора элементом управления GridView. |
|
Sorted | Происходит при щелчке по гиперссылке для сортировки столбца, но после обработки операции сортировки элементом управления GridView. |
|
Sorting | Происходит при щелчке по гиперссылке для сортировки столбца, но до обработки операции сортировки элементом управления GridView. |
|
Unload | Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control.) |
| Имя | Описание | |
|---|---|---|
|
EnablePersistedSelection | Позволяет сохранять выделение в элементах управления данными, поддерживающих выделение и разбиение по страницам. (Определено в DynamicDataExtensions.) |
|
FindDataSourceControl | Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. (Определено в DynamicDataExtensions.) |
|
FindFieldTemplate | Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. (Определено в DynamicDataExtensions.) |
|
FindMetaTable | Возвращает объект метатаблицы для контейнерного элемента управления данными. (Определено в DynamicDataExtensions.) |
| Имя | Описание | |
|---|---|---|
|
IAttributeAccessor.GetAttribute | Инфраструктура. Возвращает атрибуту веб-элемента управления указанное имя. (Унаследовано от WebControl.) |
|
IAttributeAccessor.SetAttribute | Задает атрибуту веб-элемента управления указанное имя и значение. (Унаследовано от WebControl.) |
|
ICallbackContainer.GetCallbackScript | Инфраструктура. Создает скрипт ответа для кнопки, выполняющей операцию сортировки. |
|
ICallbackEventHandler.GetCallbackResult | Инфраструктура. Возвращает результат события обратного вызова, предназначенного для элемента управления. |
|
ICallbackEventHandler.RaiseCallbackEvent | Инфраструктура. Создает аргументы для обработчика ответов в методе GetCallbackEventReference. |
|
IControlBuilderAccessor.ControlBuilder | Описание этого элемента см. в разделе IControlBuilderAccessor.ControlBuilder. (Унаследовано от Control.) |
|
IControlDesignerAccessor.GetDesignModeState | Описание этого элемента см. в разделе IControlDesignerAccessor.GetDesignModeState. (Унаследовано от Control.) |
|
IControlDesignerAccessor.SetDesignModeState | Описание этого элемента см. в разделе IControlDesignerAccessor.SetDesignModeState. (Унаследовано от Control.) |
|
IControlDesignerAccessor.SetOwnerControl | Инфраструктура. Описание этого элемента см. в разделе IControlDesignerAccessor.SetOwnerControl. (Унаследовано от Control.) |
|
IControlDesignerAccessor.UserData | Описание этого элемента см. в разделе IControlDesignerAccessor.UserData. (Унаследовано от Control.) |
|
IDataBindingsAccessor.DataBindings | Описание этого элемента см. в разделе IDataBindingsAccessor.DataBindings. (Унаследовано от Control.) |
|
IDataBindingsAccessor.HasDataBindings | Описание этого элемента см. в разделе IDataBindingsAccessor.HasDataBindings. (Унаследовано от Control.) |
|
IDataBoundControl.DataKeyNames | Получает или задает имена полей первичных ключей для элементов, отображаемых в элементе с привязкой к данным. |
|
IDataBoundControl.DataMember | Получает или задает таблицу, предоставляемую элементом управления источником данных для связывания с данным элементом управления с привязкой к данным. |
|
IDataBoundControl.DataSource | Получает или задает объект источника данных, из которого элемент управления с привязкой к данным извлекает список элементов данных. |
|
IDataBoundControl.DataSourceID | Получает или задает идентификатор источника данных, из которого элемент управления с привязкой к данным извлекает список элементов данных. |
|
IDataBoundControl.DataSourceObject | Получает или задает объект источника данных, из которого элемент управления с привязкой к данным извлекает список элементов данных. |
|
IDataBoundListControl.ClientIDRowSuffix | Получает или задает имена полей данных, значения которых добавляются к значению свойства ClientID для однозначной идентификации каждого экземпляра элемента управления с привязкой к данным. |
|
IDataBoundListControl.DataKeys | Получает коллекцию объектов, представляющих значение свойства DataKeys в элементе управления с привязкой к данным. |
|
IDataBoundListControl.EnablePersistedSelection | Получает или задает значение, указывающее, на чем основан выбор строки: на значениях индекса или значениях ключей данных. |
|
IDataBoundListControl.SelectedDataKey | Получает объект, содержащий значение ключа данных для выбранной строки в элементе управления с привязкой к данным. |
|
IDataBoundListControl.SelectedIndex | Получает или задает индекс выбранной строки в элементе управления с привязкой к данным. |
|
IDataKeysControl.ClientIDRowSuffixDataKeys | Инфраструктура. Получает значения данных, используемые для однозначной идентификации каждого экземпляра элемента управления с привязкой к данным при формировании платформой ASP.NET значения ClientID. |
|
IExpressionsAccessor.Expressions | Описание этого элемента см. в разделе IExpressionsAccessor.Expressions. (Унаследовано от Control.) |
|
IExpressionsAccessor.HasExpressions | Описание этого элемента см. в разделе IExpressionsAccessor.HasExpressions. (Унаследовано от Control.) |
|
IFieldControl.FieldsGenerator | Получает или задает элемент управления, который автоматически формирует столбцы для элемента управления с привязкой к данным и используется платформой динамических данных ASP.NET. |
|
IParserAccessor.AddParsedSubObject | Описание этого элемента см. в разделе IParserAccessor.AddParsedSubObject. (Унаследовано от Control.) |
|
IPersistedSelector.DataKey | Описание этого члена см. в разделе IPersistedSelector.DataKey. |
|
IPostBackContainer.GetPostBackOptions | Инфраструктура. Создает объект PostBackOptions, который представляет поведение элемента управления "Кнопка" после обратной передачи. |
|
IPostBackEventHandler.RaisePostBackEvent | Инфраструктура. Генерирует соответствующее событие для элемента управления GridView, когда он выполняет обратную передачу серверу. |
Содержание раздела
Введение
Элемент управления GridView используется для отображения значений источника данных в таблице. Каждый столбец представляет поле, пока каждая строка представляет запись. Элемент управления GridView поддерживает следующие функциональные возможности:
-
Привязка элементов управления к источнику данных, например, SqlDataSource.
-
Встроенные возможности сортировки.
-
Встроенные возможности обновления и удаления.
-
Встроенные возможности разбиения памяти по страницам.
-
Встроенные возможности выбора строки.
-
Программный доступ к модели объекта GridView для динамической установки значений, обработки событий и т. д.
-
Множественные ключевые поля.
-
Множественные ключевые поля для столбцов гиперссылок.
-
Настраиваемый вид с использованием тем и стилей.
-
Для подробной информации о иных элементах управления, привязанных к данным, доступных в ASP.NET, см. Общие сведения о серверных веб-элементах управления ASP.NET с привязкой к данным.
Поля столбца
Каждый столбец в элементе управления GridView, представляемый объектом DataControlField. По умолчанию свойство AutoGenerateColumns имеет значение true, которое указывает создать объект AutoGeneratedField для каждого поля в источнике данных. После этого все поля выводятся в виде столбцов в элементе управления GridView в том порядке, в котором они расположены в источнике данных.
Можно также вручную управлять отображением полей столбцов в элементе управления GridView, присвоив свойству AutoGenerateColumns значение false, а затем определив собственную коллекцию полей столбца. Различные типы полей столбцов определяют их характеристики в элементе управления. В приведенной ниже таблице приведены различные типы используемых полей столбцов.
|
Тип поля столбца |
Описание |
|---|---|
|
Отображает значение поля в источнике данных. Это стандартный тип столбца для элемента управления GridView. |
|
|
Отображает кнопку для каждой записи в элементе управления GridView. Это позволяет создать столбец пользовательских элементов управления — кнопок, например "Добавить" или "Удалить". |
|
|
Отображает флаг для каждой записи в элементе управления GridView. Данное поле столбца обычно используется для отображения полей с логическими значениями. |
|
|
Отображает предопределенные командные кнопки для выполнения операций выбора, правки или удаления. |
|
|
Отображает значение поля в источнике данных, как гиперссылку. Данный тип поля столбца позволяет привязывать второе поле к URL-адресу гиперссылки. |
|
|
Отображает изображение для каждой записи в элементе управления GridView. |
|
|
Отображает определенное пользователем содержимое для каждого элемента в элементе управления GridView, в соответствии с указанным шаблоном. Данный тип поля столбца позволяет создавать настраиваемый тип поля столбца. |
Для декларативного определения коллекции полей столбца, необходимо сначала добавить открывающий и закрывающий тэги <Columns> внутри открывающего и закрывающего тэгов элемента управления GridView. Далее следует внести список полей, которые следует поместить между открывающим и закрывающим тэгами <Columns>. Заданные столбцы добавляются в коллекцию Columns в указанном порядке. Коллекция Columns хранит все поля столбца в элементе управления и позволяет программно управлять полями столбца в элементе управления GridView.
Объявленные явным образом поля столбцов могут отображаться вместе с автоматически создаваемыми полями столбцов. При использовании обоих типов столбцов в первую очередь выводятся явно заданные поля столбцов, а затем — автоматически созданные поля столбцов.
Примечание
|
|---|
|
Автоматически созданные поля столбцов не добавляются в коллекцию Columns. |
Привязка к данным
Элемент управления GridView можно привязать к элементу управления источником данных (например, элемент управления SqlDataSource или ObjectDataSource) или к любой коллекции источников данных, реализующей интерфейс System.Collections.IEnumerable (например, System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List(Of T) или другие типы коллекций). Для привязки элемента управления GridView соответствующему источнику данных, следует воспользоваться одним из следующих методов:
-
Для привязки элемента управления источником данных, следует задать свойству DataSourceID элемента управления GridView значение ID элемента управления источником данных. Элемент управления GridView становится привязанным к указанному элементу управления источника данных, может воспользоваться возможностями элемента управления источником данных для выполнения сортировки, обновления, удаления и разбиения по страницам. Такой метод привязки к данным является предпочтительным.
-
Для привязки источника данных, реализующего интерфейс System.Collections.IEnumerable, следует программно задать свойству DataSource элемента управления GridView значение источника данных и вызвать метод DataBind. При использовании этого метода, элемент управления GridView не предоставляет встроенные возможности сортировки, обновления, удаления и разбиения по страницам. Данные возможности следует реализовать при помощи соответствующих событий.
Дополнительные сведения о привязке данных см. в разделе Доступ к данным ASP.NET.
Примечание
|
|---|
|
Этот элемент управления можно использовать для отображения введенных данных, в которых потенциально содержится вредоносный клиентский скрипт. Прежде чем использовать в исполняемых скриптах приложения, операторах SQL или другом коде присланные клиентом данные, их следует обязательно проверять. По возможности рекомендуется отображать в данном элементе управления HTML-кодированные значения (по умолчанию — HTML-кодированные значения класса BoundField). ASP.NET позволяет проверить введенные пользователем данные с целью блокирования содержащихся в них скриптов и HTML-кода. Для доступа к вводимым данным также имеются серверные элементы управления проверкой данных. Дополнительные сведения см. в разделе Introduction to the Validation Controls. |
Операции с данными
Элемент управления GridView предоставляет множество встроенных возможностей для пользовательских сортировки, обновления, удаления, выбора и страницы, посредством элементов элемента управления. Когда элемент управления GridView привязан к элементу управления источником данных, элемент управления GridView может воспользоваться возможностями элемента управления источником данных для предоставления автоматической сортировки, обновления и удаления.
Примечание
|
|---|
|
Элемент управления GridView может предоставлять поддержку сортировки, обновления и удаления для иных типов источников данных. Однако, следует создать подходящий обработчик событий с реализацией этих операций. |
Сортировка позволяет пользователю сортировать элементы в элементе управления GridView в соответствии с определенным столбцом, посредством щелчка по его заголовку. Чтобы включить сортировку, присвойте свойству AllowSorting значение true.
Автоматическое обновление, удаление и выбор активируются по щелчку кнопки с командным именем "Править", "Удалить" или "Выбрать" в поле столбца ButtonField или TemplateField. Элемент управления может GridView автоматически добавлять поле столбца CommandField с кнопками "Править", "Удалить" или "Выбрать", если свойство AutoGenerateEditButton, AutoGenerateDeleteButton, или AutoGenerateSelectButton имеет значение true.
Примечание
|
|---|
|
Элемент управления GridView не поддерживает прямого внесения записей в источник данных. Однако, возможно вносить записи, используя элемент управления GridView в сочетании с элементом управления DetailsView или FormView. Дополнительные сведения см. в разделе DetailsView или FormView. |
Вместо одновременного отображение сразу всех записей в источнике данных, элемент управления GridView может автоматически разбить их на несколько страниц. Чтобы включить разбиение по страницам, присвойте свойству AllowPaging значение true.
Примечание
|
|---|
|
Элемент управления GridView повторно создается при обратной передаче, основываясь на информации, хранимой в ViewState. Если элемент управления GridView включает TemplateField или CommandField со свойством CausesValidation, имеющим значение true, свойство EnableViewState также должно получить значение true для гарантирования применения параллельных операций, как обновления и удаления к правильным строкам. |
Настройка пользовательского интерфейса
Можно настроить внешний вид элемента управления GridView, задав свойства, определяющие стиль различных частей элемента управления. В приведенной ниже таблице приведен список различных свойств стиля.
|
Свойство стиля |
Описание |
|---|---|
|
Настройки стиля для изменения строк данных в элементу управления GridView. Если заданно это свойство, строки данных изменяются между настройками RowStyle и настройками AlternatingRowStyle. |
|
|
Установки стиля для редактируемой строки в элемента управления GridView. |
|
|
Установки стиля для пустой строки данных, отображаемой в элементе управления GridView, когда источник данных не содержит записей. |
|
|
Установки стиля строки нижнего колонтитула элемента управления GridView. |
|
|
Установки стиля строки верхнего колонтитула элемента управления GridView. |
|
|
Установки стиля строки страницы элемента управления GridView. |
|
|
Настройки стиля для строк данных в элементу управления GridView. Если свойство AlternatingRowStyle тоже задано, строки данных изменяются между настройками RowStyle и настройками AlternatingRowStyle. |
|
|
Установки стиля выбранной строки элемента управления GridView. |
|
|
Настройка стиля для столбца данных, по которому сортируются данные в элементе управления GridView. Если задан этот стиль (например, выделенному столбцу), он применяется к ячейкам, если данные сортированы по возрастанию. |
|
|
Настройка стиля для столбца данных, по которому сортируются данные в элементе управления GridView. Когда установлен этот стиль, стрелка, показывающая сортировку данных по возрастанию, помещается в заголовке элемента управления GridView, когда данные отсортированы по возрастанию. |
|
|
Настройка стиля для столбца данных, по которому сортируются данные в элементе управления GridView. Если задан этот стиль (например, выделенному столбцу), он применяется к ячейкам, если данные сортированы по убыванию. |
|
|
Настройка стиля для столбца данных, по которому сортируются данные в элементе управления GridView. Когда задан этот стиль, в заголовок GridView помещается стрелка, указывающая вниз, когда данные сортируются в порядке убывания. |
Можно также отобразить или скрыть различные части элемента управления. В приведенной ниже таблице содержится список свойств, определяющих, какие части отображены, а какие — скрыты.
|
Свойство |
Описание |
|---|---|
|
Отображает или скрывает нижний колонтитул элемента управления GridView. |
|
|
Отображает или скрывает верхний колонтитул элемента управления GridView. |
События
В элементе управления GridView предусмотрено несколько событий, которые можно запрограммировать. Это позволяет запускать пользовательские процедуры при каждом происхождении события. В следующей таблице перечислены события, поддерживаемые элементом управления GridView.
|
Событие |
Описание |
|---|---|
|
Происходит при щелчке кнопки страницы, но после обработки операции разбиения по страницам элементом управления GridView. Данное событие часто используется при выполнении задачи после пользовательского перехода на другую страницу в элементе управления. |
|
|
Происходит при щелчке кнопки страницы, но перед обработкой операции разбиения по страницам элементом управления GridView. Данное событие часто используется для отмены операции разбиения по страницам. |
|
|
Происходит при щелчке по кнопке "Отменить" в строке, но до выхода элемента управления из режима правки GridView. Данное событие часто используется для остановки операции отмены. |
|
|
Происходит при нажатии кнопки в элементе управления GridView. Данное событие часто используется для выполнения задачи при нажатии кнопки в элементе управления. |
|
|
Происходит при создании новой строки в элементе управления GridView. Данное событие часто используется для изменения содержимого строки после ее создания. |
|
|
Происходит при привязке строки данных к данным в элементе управления GridView. Данное событие часто используется для изменения содержимого строки после ее привязки к данным. |
|
|
Происходит при щелчке по кнопке строки "Удалить", но после удаления элементом управления GridView записи из источника данных. Это событие часто используется для проверки результатов операции удаления. |
|
|
Происходит при щелчке по кнопке строки "Удалить", но перед удаления элементом управления GridView записи из источника данных. Данное событие часто используется для отмены операции удаления. |
|
|
Происходит при щелчке по кнопке "Править" в строке, но до входа элемента управления в режим правки GridView. Данное событие часто используется для отмены операции правки. |
|
|
Происходит при щелчке по кнопке "Обновить" в строке, но после обновления строки элементом управления GridView. Это событие часто используется для проверки результатов операции обновления. |
|
|
Происходит при щелчке по кнопке "Обновить" в строке, но до обновления строки элементом управления GridView. Данное событие часто используется для отмены операции обновления. |
|
|
Происходит при щелчке по кнопке строки "Выбрать", но после обработки операции выбора элементом управления GridView. Данное событие часто используется для выполнения задачи, после выбора строки в элементе управления. |
|
|
Происходит при щелчке по кнопке строки "Выбрать", но до обработки операции выбора элементом управления GridView. Данное событие часто используется для отмены операции выбора. |
|
|
Происходит при щелчке по гиперссылке для сортировки столбца, но после обработки операции сортировки элементом управления GridView. Это событие часто используется для выполнения задачи после щелчка пользователя по гиперссылке для сортировки столбца. |
|
|
Происходит при щелчке по гиперссылке для сортировки столбца, но до обработки операции сортировки элементом управления GridView. Данное событие часто используется для отмены операции сортировки или выполнения настраиваемой сортировки. |
Специальные возможности
Дополнительные сведения о настройке этого элемента управления таким образом, чтобы он создавал разметку, которая соответствует стандартам специальных возможностей, содержатся в разделах Специальные возможности Visual Studio и ASP.NET и Элементы управления ASP.NET и специальные возможности.
Декларативный синтаксис
<asp:GridView
AccessKey="string"
AllowPaging="True|False"
AllowSorting="True|False"
AutoGenerateColumns="True|False"
AutoGenerateDeleteButton="True|False"
AutoGenerateEditButton="True|False"
AutoGenerateSelectButton="True|False"
BackColor="color name|#dddddd"
BackImageUrl="uri"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataKeyNames="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
EditIndex="integer"
EmptyDataText="string"
Enabled="True|False"
EnableSortingAndPagingCallbacks="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
ID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPageIndexChanged="PageIndexChanged event handler"
OnPageIndexChanging="PageIndexChanging event handler"
OnPreRender="PreRender event handler"
OnRowCancelingEdit="RowCancelingEdit event handler"
OnRowCommand="RowCommand event handler"
OnRowCreated="RowCreated event handler"
OnRowDataBound="RowDataBound event handler"
OnRowDeleted="RowDeleted event handler"
OnRowDeleting="RowDeleting event handler"
OnRowEditing="RowEditing event handler"
OnRowUpdated="RowUpdated event handler"
OnRowUpdating="RowUpdating event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnSelectedIndexChanging="SelectedIndexChanging event handler"
OnSorted="Sorted event handler"
OnSorting="Sorting event handler"
OnUnload="Unload event handler"
PageIndex="integer"
PagerSettings-FirstPageImageUrl="uri"
PagerSettings-FirstPageText="string"
PagerSettings-LastPageImageUrl="uri"
PagerSettings-LastPageText="string"
PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
NumericFirstLast"
PagerSettings-NextPageImageUrl="uri"
PagerSettings-NextPageText="string"
PagerSettings-PageButtonCount="integer"
PagerSettings-Position="Bottom|Top|TopAndBottom"
PagerSettings-PreviousPageImageUrl="uri"
PagerSettings-PreviousPageText="string"
PagerSettings-Visible="True|False"
PageSize="integer"
RowHeaderColumn="string"
runat="server"
SelectedIndex="integer"
ShowFooter="True|False"
ShowHeader="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
Width="size"
>
<AlternatingRowStyle />
<Columns>
<asp:BoundField
AccessibleHeaderText="string"
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
DataField="string"
DataFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
HtmlEncode="True|False"
InsertVisible="True|False"
NullDisplayText="string"
ReadOnly="True|False"
ShowHeader="True|False"
SortExpression="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:BoundField>
<asp:ButtonField
AccessibleHeaderText="string"
ButtonType="Button|Image|Link"
CausesValidation="True|False"
CommandName="string"
DataTextField="string"
DataTextFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
ImageUrl="uri"
InsertVisible="True|False"
ShowHeader="True|False"
SortExpression="string"
Text="string"
ValidationGroup="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:ButtonField>
<asp:CheckBoxField
AccessibleHeaderText="string"
DataField="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
ReadOnly="True|False"
ShowHeader="True|False"
SortExpression="string"
Text="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:CheckBoxField>
<asp:CommandField
AccessibleHeaderText="string"
ButtonType="Button|Image|Link"
CancelImageUrl="uri"
CancelText="string"
CausesValidation="True|False"
DeleteImageUrl="uri"
DeleteText="string"
EditImageUrl="uri"
EditText="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertImageUrl="uri"
InsertText="string"
InsertVisible="True|False"
NewImageUrl="uri"
NewText="string"
SelectImageUrl="uri"
SelectText="string"
ShowCancelButton="True|False"
ShowDeleteButton="True|False"
ShowEditButton="True|False"
ShowHeader="True|False"
ShowInsertButton="True|False"
ShowSelectButton="True|False"
SortExpression="string"
UpdateImageUrl="uri"
UpdateText="string"
ValidationGroup="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:CommandField>
<asp:DynamicField
AccessibleHeaderText="string"
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
DataField="string"
DataFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
HtmlEncode="True|False"
InsertVisible="True|False"
NullDisplayText="string"
ShowHeader="True|False"
UIHint="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:DynamicField>
<asp:HyperLinkField
AccessibleHeaderText="string"
DataNavigateUrlFields="string"
DataNavigateUrlFormatString="string"
DataTextField="string"
DataTextFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
NavigateUrl="uri"
ShowHeader="True|False"
SortExpression="string"
Target="string|_blank|_parent|_search|_self|_top"
Text="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:HyperLinkField>
<asp:ImageField
AccessibleHeaderText="string"
AlternateText="string"
ConvertEmptyStringToNull="True|False"
DataAlternateTextField="string"
DataAlternateTextFormatString="string"
DataImageUrlField="string"
DataImageUrlFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
NullDisplayText="string"
NullImageUrl="uri"
ReadOnly="True|False"
ShowHeader="True|False"
SortExpression="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:ImageField>
<asp:TemplateField
AccessibleHeaderText="string"
ConvertEmptyStringToNull="True|False"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
ShowHeader="True|False"
SortExpression="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
<AlternatingItemTemplate>
<!-- child controls -->
</AlternatingItemTemplate>
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<InsertItemTemplate>
<!-- child controls -->
</InsertItemTemplate>
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
</asp:TemplateField>
</Columns>
<EditRowStyle />
<EmptyDataRowStyle />
<EmptyDataTemplate>
<!-- child controls -->
</EmptyDataTemplate>
<FooterStyle />
<HeaderStyle />
<PagerSettings
FirstPageImageUrl="uri"
FirstPageText="string"
LastPageImageUrl="uri"
LastPageText="string"
Mode="NextPrevious|Numeric|NextPreviousFirstLast|
NumericFirstLast"
NextPageImageUrl="uri"
NextPageText="string"
OnPropertyChanged="PropertyChanged event handler"
PageButtonCount="integer"
Position="Bottom|Top|TopAndBottom"
PreviousPageImageUrl="uri"
PreviousPageText="string"
Visible="True|False"
/>
<PagerStyle />
<PagerTemplate>
<!-- child controls -->
</PagerTemplate>
<RowStyle />
<SelectedRowStyle />
</asp:GridView>
Проект веб-сайта Visual Studio с исходным кодом этого примера доступен на следующей странице: Download.
В следующем примере показано использование элемента управления GridView для отображения значений таблицы Customers из примера базы данных AdventureWorksLT на Microsoft SQL Server. Значения извлекаются с помощью элемента управления SqlDataSource.
<asp:sqldatasource id="CustomersSource" selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer" connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" runat="server"/> <asp:gridview id="CustomersGridView" datasourceid="CustomersSource" autogeneratecolumns="False" emptydatatext="No data available." allowpaging="True" runat="server" DataKeyNames="CustomerID"> <Columns> <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" /> <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" SortExpression="CompanyName" /> <asp:BoundField DataField="FirstName" HeaderText="FirstName" SortExpression="FirstName" /> <asp:BoundField DataField="LastName" HeaderText="LastName" SortExpression="LastName" /> </Columns> </asp:gridview>
В следующем примере показано использование элементов управления GridView и LinqDataSource для редактирования записей.
<asp:LinqDataSource ID="LinqDataSource1" runat="server" ContextTypeName="AdventureWorksLTDataClassesDataContext" EnableDelete="True" EnableInsert="True" EnableUpdate="True" TableName="SalesOrderDetails"> </asp:LinqDataSource> <asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False" DataKeyNames="SalesOrderID,SalesOrderDetailID" DataSourceID="LinqDataSource1"> <Columns> <asp:CommandField ShowDeleteButton="True" ShowEditButton="True" /> <asp:BoundField DataField="SalesOrderID" HeaderText="SalesOrderID" ReadOnly="True" SortExpression="SalesOrderID" /> <asp:BoundField DataField="SalesOrderDetailID" HeaderText="SalesOrderDetailID" InsertVisible="False" ReadOnly="True" SortExpression="SalesOrderDetailID" /> <asp:BoundField DataField="OrderQty" HeaderText="OrderQty" SortExpression="OrderQty" /> <asp:BoundField DataField="ProductID" HeaderText="ProductID" SortExpression="ProductID" /> <asp:BoundField DataField="UnitPrice" HeaderText="UnitPrice" SortExpression="UnitPrice" /> <asp:BoundField DataField="ModifiedDate" HeaderText="ModifiedDate" SortExpression="ModifiedDate" /> </Columns> </asp:GridView>
См. пример доступа к значениям ячеек GridViewRow.
Windows 7, Windows Vista с пакетом обновления 1 (SP1) или выше, Windows XP с пакетом обновления 3 (SP3), 64-разрядный выпуск Windows XP с пакетом обновления 2 (SP2), Windows Server 2008 (Server Core не поддерживается), Windows Server 2008 R2 (Server Core поддерживается с пакетом обновления 1 (SP1) или более поздним), Windows Server 2003 SP2
.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.
|
Дата |
Журнал |
Причина |
|---|---|---|
|
Июль 2008 |
Добавлены новые члены: свойство ColumnsGenerator, свойство EnableModelValidation, свойство SelectedPersistedDataKey, свойство IPersistedSelector.DataKey. |
Изменение функции SP1. |
