Эта статья переведена вручную. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст.
Перевод
Текст оригинала
Эта тема еще не получила оценку Оценить эту тему

GridView - класс

Отображает значения источника данных в таблице, где каждый столбец представляет поле, а каждая строка — запись. Элемент управления GridView позволяет выбирать, сортировать и изменять эти записи.

Пространство имен:  System.Web.UI.WebControls
Сборка:  System.Web (в System.Web.dll)
[ControlValuePropertyAttribute("SelectedValue")]
public class GridView : CompositeDataBoundControl, IPostBackContainer, 
	IPostBackEventHandler, ICallbackContainer, ICallbackEventHandler, IPersistedSelector, IDataKeysControl, 
	IDataBoundListControl, IDataBoundControl, IFieldControl
<asp:GridView />

Тип GridView предоставляет следующие члены.

  Имя Описание
Открытый метод GridView Инициализирует новый экземпляр класса 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 с привязкой к данным.

Примечание Примечание

Для тех, кто уже знаком с элементом управления DataGrid и платформы .NET Framework 1.0 известно, что элемент управления GridView является наследником элемента управления DataGrid.

Поля столбца

Каждый столбец в элементе управления GridView, представляемый объектом DataControlField. По умолчанию свойство AutoGenerateColumns имеет значение true, которое указывает создать объект AutoGeneratedField для каждого поля в источнике данных. После этого все поля выводятся в виде столбцов в элементе управления GridView в том порядке, в котором они расположены в источнике данных.

Можно также вручную управлять отображением полей столбцов в элементе управления GridView, присвоив свойству AutoGenerateColumns значение false, а затем определив собственную коллекцию полей столбца. Различные типы полей столбцов определяют их характеристики в элементе управления. В приведенной ниже таблице приведены различные типы используемых полей столбцов.

Тип поля столбца

Описание

BoundField

Отображает значение поля в источнике данных. Это стандартный тип столбца для элемента управления GridView.

ButtonField

Отображает кнопку для каждой записи в элементе управления GridView. Это позволяет создать столбец пользовательских элементов управления — кнопок, например "Добавить" или "Удалить".

CheckBoxField

Отображает флаг для каждой записи в элементе управления GridView. Данное поле столбца обычно используется для отображения полей с логическими значениями.

CommandField

Отображает предопределенные командные кнопки для выполнения операций выбора, правки или удаления.

HyperLinkField

Отображает значение поля в источнике данных, как гиперссылку. Данный тип поля столбца позволяет привязывать второе поле к URL-адресу гиперссылки.

ImageField

Отображает изображение для каждой записи в элементе управления GridView.

TemplateField

Отображает определенное пользователем содержимое для каждого элемента в элементе управления 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, задав свойства, определяющие стиль различных частей элемента управления. В приведенной ниже таблице приведен список различных свойств стиля.

Свойство стиля

Описание

AlternatingRowStyle

Настройки стиля для изменения строк данных в элементу управления GridView. Если заданно это свойство, строки данных изменяются между настройками RowStyle и настройками AlternatingRowStyle.

EditRowStyle

Установки стиля для редактируемой строки в элемента управления GridView.

EmptyDataRowStyle

Установки стиля для пустой строки данных, отображаемой в элементе управления GridView, когда источник данных не содержит записей.

FooterStyle

Установки стиля строки нижнего колонтитула элемента управления GridView.

HeaderStyle

Установки стиля строки верхнего колонтитула элемента управления GridView.

PagerStyle

Установки стиля строки страницы элемента управления GridView.

RowStyle

Настройки стиля для строк данных в элементу управления GridView. Если свойство AlternatingRowStyle тоже задано, строки данных изменяются между настройками RowStyle и настройками AlternatingRowStyle.

SelectedRowStyle

Установки стиля выбранной строки элемента управления GridView.

SortedAscendingCellStyle

Настройка стиля для столбца данных, по которому сортируются данные в элементе управления GridView. Если задан этот стиль (например, выделенному столбцу), он применяется к ячейкам, если данные сортированы по возрастанию.

SortedAscendingHeaderStyle

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

SortedDescendingCellStyle

Настройка стиля для столбца данных, по которому сортируются данные в элементе управления GridView. Если задан этот стиль (например, выделенному столбцу), он применяется к ячейкам, если данные сортированы по убыванию.

SortedDescendingHeaderStyle

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

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

Свойство

Описание

ShowFooter

Отображает или скрывает нижний колонтитул элемента управления GridView.

ShowHeader

Отображает или скрывает верхний колонтитул элемента управления GridView.

События

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

Событие

Описание

PageIndexChanged

Происходит при щелчке кнопки страницы, но после обработки операции разбиения по страницам элементом управления GridView. Данное событие часто используется при выполнении задачи после пользовательского перехода на другую страницу в элементе управления.

PageIndexChanging

Происходит при щелчке кнопки страницы, но перед обработкой операции разбиения по страницам элементом управления GridView. Данное событие часто используется для отмены операции разбиения по страницам.

RowCancelingEdit

Происходит при щелчке по кнопке "Отменить" в строке, но до выхода элемента управления из режима правки GridView. Данное событие часто используется для остановки операции отмены.

RowCommand

Происходит при нажатии кнопки в элементе управления GridView. Данное событие часто используется для выполнения задачи при нажатии кнопки в элементе управления.

RowCreated

Происходит при создании новой строки в элементе управления GridView. Данное событие часто используется для изменения содержимого строки после ее создания.

RowDataBound

Происходит при привязке строки данных к данным в элементе управления GridView. Данное событие часто используется для изменения содержимого строки после ее привязки к данным.

RowDeleted

Происходит при щелчке по кнопке строки "Удалить", но после удаления элементом управления GridView записи из источника данных. Это событие часто используется для проверки результатов операции удаления.

RowDeleting

Происходит при щелчке по кнопке строки "Удалить", но перед удаления элементом управления GridView записи из источника данных. Данное событие часто используется для отмены операции удаления.

RowEditing

Происходит при щелчке по кнопке "Править" в строке, но до входа элемента управления в режим правки GridView. Данное событие часто используется для отмены операции правки.

RowUpdated

Происходит при щелчке по кнопке "Обновить" в строке, но после обновления строки элементом управления GridView. Это событие часто используется для проверки результатов операции обновления.

RowUpdating

Происходит при щелчке по кнопке "Обновить" в строке, но до обновления строки элементом управления GridView. Данное событие часто используется для отмены операции обновления.

SelectedIndexChanged

Происходит при щелчке по кнопке строки "Выбрать", но после обработки операции выбора элементом управления GridView. Данное событие часто используется для выполнения задачи, после выбора строки в элементе управления.

SelectedIndexChanging

Происходит при щелчке по кнопке строки "Выбрать", но до обработки операции выбора элементом управления GridView. Данное событие часто используется для отмены операции выбора.

Sorted

Происходит при щелчке по гиперссылке для сортировки столбца, но после обработки операции сортировки элементом управления GridView. Это событие часто используется для выполнения задачи после щелчка пользователя по гиперссылке для сортировки столбца.

Sorting

Происходит при щелчке по гиперссылке для сортировки столбца, но до обработки операции сортировки элементом управления 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>
Topic Location
Практическое руководство. Включение удаления по умолчанию в серверном веб-элементе управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Простая сортировка для серверного веб-элемента управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Привязка данных веб-страниц с помощью компонента данных Visual Studio Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Редактирование и вставка данных в веб-страницы с помощью серверного веб-элемента управления DetailsView Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Настройка элементов управления для редактирования в серверном веб-элементе управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Создание и использование главных страниц ASP.NET в Visual Web Developer Построение приложений при помощи Visual Web Developer
Практическое руководство. Декларативное создание шаблонов веб-элемента управления ASP.NET Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Подключение к базе данных Access с помощью элемента управления AccessDataSource Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Ответ на события кнопок в элементе управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Основы доступа к данным на веб-страницах Построение приложений при помощи Visual Web Developer
Практическое руководство. Включение выбранных элементов по умолчанию в серверном веб-элементе управления GridView Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Создание шаблонов серверных веб-элементов управления с помощью конструктора Построение веб-приложений ASP.NET в Visual Studio
Практические руководство. Динамическое создание шаблонов серверных веб-элементов управления ASP.NET Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Динамическая установка ширины столбцов серверного веб-элемента управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Создание веб-страниц для отображения XML-данных Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Связывание данных в шаблонном элементе управления Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Привязка данных к пользовательским бизнес-объектам Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Создание веб-страницы для отображения данных базы данных Access Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Отображение раскрывающегося списка при редактировании в серверном веб-элементе управления GridView Построение приложений при помощи Visual Web Developer
Пошаговое руководство. Выполнение массовых обновлений строк, связанных с серверным веб-элементом управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Отображение данных с помощью хранимой процедуры в серверном веб-элементе управления GridView Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Включение редактирования в серверном веб-элементе управления GridView по умолчанию Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Включение разбиения по страницам по умолчанию в серверном веб-элементе управления GridView Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Привязка данных к шаблонному элементу управления в Visual Studio Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство: создание основных веб-страниц и страниц подробностей в Visual Studio Построение приложений при помощи Visual Web Developer
Пошаговое руководство. Создание вложенного элемента управления GridView Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Отклик на события Button в элементах DataList или Repeater Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Отображение XML-документа на странице Web Forms с помощью преобразований Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Отображение раскрывающегося списка при редактировании в серверном веб-элементе управления GridView dv_vwdcon

Проект веб-сайта 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.

.NET Framework

Поддерживается в версиях: 4, 3.5, 3.0, 2.0

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.
Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

Дата

Журнал

Причина

Июль 2008

Добавлены новые члены: свойство ColumnsGenerator, свойство EnableModelValidation, свойство SelectedPersistedDataKey, свойство IPersistedSelector.DataKey.

Изменение функции SP1.

Считаете ли вы эту страницу полезной?
(Осталось символов: 1500)
Содержимое сообщества Добавить