DatabaseTable
Графический объект; таблица, которая работает с данными базы.
Шаблон DatabaseTable
Перечень всех возможных тэгов объекта:
Описание DatabaseTable
DatabaseTable не имеет значения.
Тэги, общие для всех графических объектов
Width
Ширина таблицы.
Необязательный тэг. Ожидается целочисленное значение.
Если тэг <Width>
отсутствует, то ширина таблицы определяется шириной всех ее видимых столбцов.
ContextMenu
Контекстное меню объекта.
Необязательный тэг. Значение тэга <ContextMenu>
: не ожидается.
Атрибуты тэга <ContextMenu>
<ContextMenu>
Name | Название контекстного меню для случая, когда выделена только одна строка в таблице. Обязательный атрибут. Ожидается название одного из контекстных меню, описанных на форме. |
MultiSelection | Название контекстного меню для случая, когда выделено больше одной строки в таблице. Необязательный атрибут. Ожидается название одного из контекстных меню, описанных на форме. |
Тэги, специфичные для DatabaseTable
RowHeight
Высота строк с данными в таблице.
Необязательный тэг. Значение тэга <RowHeight>
: не ожидается.
Если тэг <RowHeight>
отсутствует, то для атрибута Value
используется стандартное значение .NET.
Атрибуты тэга <RowHeight>
<RowHeight>
Value | Значение. Обязательный атрибут. Ожидается целочисленное значение. |
ColumnHeadersHeight
Высота "шапки" таблицы.
Необязательный тэг. Значение тэга <ColumnHeadersHeight>
: не ожидается.
Если тэг <ColumnHeadersHeight>
отсутствует, то для атрибута Value
используется стандартное значение .NET.
Атрибуты тэга <ColumnHeadersHeight>
<ColumnHeadersHeight>
Value | Значение. Обязательный атрибут. Ожидается целочисленное значение. |
ColumnHeadersVisible
Признак, определяющий, показывать или нет "шапку" таблицы.
Необязательный тэг. Значение тэга <ColumnHeadersVisible>
: не ожидается.
Если тэг <ColumnHeadersVisible>
отсутствует, то для атрибута Value
используется значение True.
Атрибуты тэга <ColumnHeadersVisible>
<ColumnHeadersVisible>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
RowHeadersWidth
Ширина "нулевого" столбца таблицы.
Необязательный тэг. Значение тэга <RowHeadersWidth>
: не ожидается.
Если тэг <RowHeadersWidth>
отсутствует, то для атрибута Value
используется стандартное значение .NET.
Атрибуты тэга <RowHeadersWidth>
<RowHeadersWidth>
Value | Значение. Обязательный атрибут. Ожидается целочисленное значение. |
RowHeadersVisible
Признак, определяющий, показывать или нет "нулевой" столбец таблицы.
Необязательный тэг. Значение тэга <RowHeadersVisible>
: не ожидается.
Если тэг <RowHeadersVisible>
отсутствует, то для атрибута Value
используется значение False.
Атрибуты тэга <RowHeadersVisible>
<RowHeadersVisible>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
BackgroundColor
Цвет фона таблицы.
Необязательный тэг. Значение тэга <BackgroundColor>
: не ожидается.
Если тэг <BackgroundColor>
отсутствует, то для атрибута Value
используется стандартное значение .NET.
Атрибуты тэга <BackgroundColor>
<BackgroundColor>
Value | Значение. Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). |
BorderStyle
Название типа границ таблицы.
Необязательный тэг. Значение тэга <BorderStyle>
: не ожидается.
Если тэг <BorderStyle>
отсутствует, то для атрибута Value
используется значение FixedSingle.
Атрибуты тэга <BorderStyle>
<BorderStyle>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов границ таблицы. |
Типы границ таблицы
None | Нет границ |
FixedSingle | Одиночная плоская |
Fixed3D | Одиночная объемная |
CellBorderStyle
Название стиля границ ячеек в таблице.
Необязательный тэг. Значение тэга <CellBorderStyle>
: не ожидается.
Если тэг <CellBorderStyle>
отсутствует, то для атрибута Value
используется значение Single.
Атрибуты тэга <CellBorderStyle>
<CellBorderStyle>
Value | Значение. Обязательный атрибут. Ожидается название одного из стилей границ ячеек в таблице. |
Стили границ ячеек
Custom | Граница, которая была настроена |
Single | Одинарная граница |
Raised | Трехмерная выпуклая граница |
Sunken | Трехмерная утопленная граница |
None | Отсутствие границ |
SingleVertical | Вертикальная одинарная граница |
RaisedVertical | Вертикальная трехмерная выпуклая граница |
SunkenVertical | Вертикальная трехмерная утопленная граница |
SingleHorizontal | Горизонтальная одинарная граница |
RaisedHorizontal | Горизонтальная трехмерная выпуклая граница |
SunkenHorizontal | Горизонтальная трехмерная утопленная граница |
HideSelection
Признак видимости выделения в таблице.
Необязательный тэг. Значение тэга <HideSelection>
: не ожидается.
Если тэг <HideSelection>
отсутствует, то для атрибута Value
используется значение False.
Атрибуты тэга <HideSelection>
<HideSelection>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
Замечание. Невидимость выделения задается посредством присвоения внутренним свойствам <SelectionForeColor>
и <SelectionBackColor>
значений из свойств <ForeColor>
и <BackColor>
, либо при задании значения True для set-проперти HideSelection.
SelectionColor
Настройки цвета выделения в таблице.
Необязательный тэг. Значение тэга <SelectionColor>
: не ожидается.
Если тэг <SelectionColor>
отсутствует, то используется системный цвет выделения.
Атрибуты тэга <SelectionColor>
<SelectionColor>
Name | Имя цвета или описание цвета в формате HTML (#rrggbb). Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме. |
FadingRatio | Степень остатка цвета фона при выделении (0 - минимальный остаток, выделенная строка полностью закрашена цветом; 1 - минимальный остаток, выделенная строка не закрашена вовсе). Необязательный атрибут. Ожидается числовое значение от 0 до 1. Если атрибут |
AllowInsert
Признак, определяющий, может ли пользователь добавлять строки в таблицу посредством графического интерфейса таблицы.
Необязательный тэг. Ожидается логическое значение.
Если тэг <AllowInsert>
отсутствует, то используется значение True.
AllowUpdate
Признак, определяющий, может ли пользователь изменять значения в строках таблицы посредством графического интерфейса таблицы.
Необязательный тэг. Ожидается логическое значение.
Если тэг <AllowUpdate>
отсутствует, то используется значение True.
AllowDelete
Признак, определяющий, может ли пользователь удалять строки из таблицы посредством графического интерфейса таблицы.
Необязательный тэг. Ожидается логическое значение.
Если тэг <AllowDelete>
отсутствует, то используется значение True.
MultiSelect
Признак, определяющий, можно ли выделить в таблице более одной строки одновременно.
Необязательный тэг. Значение тэга <MultiSelect>
: не ожидается.
Если тэг <MultiSelect>
отсутствует, то для атрибута Value
используется значение False.
Атрибуты тэга <MultiSelect>
<MultiSelect>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
ScrollBars
Признак, определяющий, тип полос прокрутки в таблице.
Необязательный тэг. Значение тэга <ScrollBars>
: не ожидается.
Если тэг <ScrollBars>
отсутствует, то для атрибута Value
используется значение Both.
Атрибуты тэга <ScrollBars>
<ScrollBars>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов полос прокрутки в таблице. |
Типы полос прокрутки
Both | Разрешены вертикальная и горизонтальная полосы прокрутки |
Vertical | Только вертикальная полоса прокрутки |
Horizontal | Только горизонтальная полоса прокрутки |
None | Нет полос прокрутки |
SelectionMode
Название типа выделения таблицы.
Необязательный тэг. Значение тэга <SelectionMode>
: не ожидается.
Если тэг <SelectionMode>
отсутствует, то для атрибута Value используется значение FullRowSelect.
Атрибуты тэга <SelectionMode>
<SelectionMode>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов выделения таблицы. |
Типы выделения таблицы
CellSelect | Выделение ячеек по отдельности |
FullRowSelect | Выделение всей строки сразу |
FullColumnSelect | Выделение всего столбца сразу (возможно применить только, если в таблице нет столбцов с характеристикой SortMode, имеющей значение True) |
RowHeaderSelect | Выделение ячеек по отдельности с возможностью выделить сразу всю строку) |
ColumnHeaderSelect | Выделение ячеек по отдельности с возможностью выделить сразу весь столбец) |
BeginEditOnCellEnter
Признак, определяющий, будет ли выделенная ячейка автоматически переводится в режим редактирования.
Необязательный тэг. Значение тэга не ожидается.
По умолчанию для атрибута Value
используется значение False.
EditMode
Название типа редактирования ячеек таблицы.
Необязательный тэг. Значение тэга не ожидается.
В атрибуте Value
ожидается название одного из типов редактирования ячеек таблицы:
CellSelectEditOnEnter | Редактирование начинается, когда ячейка получает фокус |
EditOnF2 | Редактирование начинается при нажатии на кнопку F2, когда ячейка имеет фокус |
EditOnKeystroke | Редактирование начинается при нажатии на любую букво-цифровую кнопку, когда ячейка имеет фокус |
EditOnKeystrokeOrF2 | Редактирование начинается при нажатии на кнопку F2 или на любую букво-цифровую кнопку, когда ячейка имеет фокус |
EditProgrammatically | Редактирование через графический интерфейс таблицы запрещено |
По умолчанию для атрибута Value
используется значение EditOnKeystrokeOrF2.
AllowResizeColumns
Признак, определяющий, может ли пользователь изменять ширину столбцов посредством графического интерфейса таблицы.
Необязательный тэг. Значение тэга <AllowResizeColumns>
: не ожидается.
Если тэг <AllowResizeColumns>
отсутствует, то для атрибута Value
используется значение True.
Атрибуты тэга <AllowResizeColumns>
<AllowResizeColumns>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
AllowOrderColumns
Признак, определяющий, может ли пользователь изменять порядок отображения столбцов посредством графического интерфейса таблицы.
Необязательный тэг. Значение тэга <AllowOrderColumns>
: не ожидается.
Если тэг <AllowOrderColumns>
отсутствует, то для атрибута Value
используется значение False.
Атрибуты тэга <AllowOrderColumns>
<AllowOrderColumns>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
AllowResizeRows
Признак, определяющий, может ли пользователь изменять высоту строк посредством графического интерфейса таблицы.
Необязательный тэг. Значение тэга <AllowResizeRows>
: не ожидается.
Если тэг <AllowResizeRows>
отсутствует, то для атрибута Value
используется значение True.
Атрибуты тэга <AllowResizeRows>
<AllowResizeRows>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
AutoSizeRowsMode
Название типа автоматического изменения высоты строк таблицы.
Необязательный тэг. Значение тэга <AutoSizeRowsMode>
: не ожидается.
Если тэг <AutoSizeRowsMode>
отсутствует, то для атрибута Value
используется значение None.
Атрибуты тэга <AutoSizeRowsMode>
<AutoSizeRowsMode>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов автоматического изменения высоты строк таблицы. |
Типы автоматического изменения высоты строк таблицы
None | Нет автоматического изменения высоты строк таблицы |
AllCells | Высота строк изменяется в соответствии с содержимым всех ячеек в строках, включая ячейки заголовка |
AllCellsExceptHeaders | Высота строк изменяется в соответствии с содержимым всех ячеек в строках, исключая ячейки заголовка |
AllHeaders | Высота строк изменяется в соответствии с содержимым заголовка строк |
DisplayedCells | Высота строк изменяется в соответствии с содержимым всех ячеек в строках, отображаемых в текущий момент на экране, включая ячейки заголовка |
DisplayedCellsExceptHeaders | Высота строк изменяется в соответствии с содержимым всех ячеек в строках, отображаемых в текущий момент на экране, исключая ячейки заголовка |
DisplayedHeaders | Высота строк изменяется в соответствии с содержимым заголовков строк, отображаемых в текущий момент на экране |
AutoSizeColumnsMode
Название типа автоматического изменения ширины столбцов таблицы.
Необязательный тэг. Значение тэга <AutoSizeColumnsMode>
: не ожидается.
Если тэг <AutoSizeColumnsMode>
отсутствует, то для атрибута Value
используется значение None.
Атрибуты тэга <AutoSizeColumnsMode>
<AutoSizeColumnsMode>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов автоматического изменения ширины столбцов таблицы. |
Типы автоматического изменения ширины столбцов таблицы
None | Пропорциональное автоматическое изменение ширины столбцов относительно ширины таблицы |
AllCells | Ширина столбцов изменяется в соответствии с содержимым всех ячеек в столбцах, включая ячейки заголовка |
AllCellsExceptHeader | Ширина столбцов изменяется в соответствии с содержимым всех ячеек в столбцах, исключая ячейки заголовка |
ColumnHeader | Ширина столбцов изменяется в соответствии с содержимым заголовка столбцов |
DisplayedCells | Ширина столбцов изменяется в соответствии с содержимым всех ячеек в столбцах, отображаемых в текущий момент на экране, включая ячейки заголовка |
DisplayedCellsExceptHeaders | Ширина столбцов изменяется в соответствии с содержимым всех ячеек в столбцах, отображаемых в текущий момент на экране, исключая ячейки заголовка |
Fill | Ширина столбцов изменяется так, чтобы точно заполнить ширину всей отображаемой области таблицы, с учетом наличия или отсутствия полосы горизонтальной прокрутки |
Disable | Нет автоматического изменения ширины столбцов таблицы |
AllowFilterColumns
Признак, определяющий, может ли пользователь фильтровать таблицу.
Необязательный тэг. Значение тэга <AllowFilterColumns>
: не ожидается.
Если тэг <AllowFilterColumns>
отсутствует, то для атрибута Value
используется значение True.
Атрибуты тэга <AllowFilterColumns>
<AllowFilterColumns>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
ColumnHeadersHeightSizeMode
Название типа возможности изменения высоты шапки таблицы.
Необязательный тэг. Значение тэга <ColumnHeadersHeightSizeMode>
: не ожидается.
Если тэг <ColumnHeadersHeightSizeMode>
отсутствует, то для атрибута Value
используется значение DisableResizing.
Атрибуты тэга <ColumnHeadersHeightSizeMode>
<ColumnHeadersHeightSizeMode>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов возможности изменения высоты шапки таблицы. |
Типы возможности изменения высоты шапки таблицы
AutoSize | Автоматическая высота шапки таблицы |
EnableResizing | Возможность изменения высоты шапки таблицы |
DisableResizing | Запрет на изменения высоты шапки таблицы |
ColumnHeadersAlignment
Название типа положения содержимого заголовка столбца таблицы.
Необязательный тэг. Значение тэга <ColumnHeadersAlignment>
: не ожидается.
Если тэг <ColumnHeadersAlignment>
отсутствует, то для атрибута Value
используется значение NotSet.
Атрибуты тэга <ColumnHeadersAlignment>
<ColumnHeadersAlignment>
Value | Значение. Обязательный атрибут. Ожидается название одного из типов положения содержимого ячейки столбца таблицы. |
Типы положения содержимого ячейки столбца таблицы
NotSet | Не установлено |
TopLeft | Содержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении |
TopCenter | Содержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки |
TopRight | Содержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении |
MiddleLeft | Содержимое выравнивается вертикально по середине и горизонтально по левому краю ячейки в горизонтальном направлении |
MiddleCenter | Содержимое выравнивается по вертикальному и горизонтальному центру ячейки |
MiddleRight | Содержимое выравнивается вертикально по середине и горизонтально по правому краю ячейки в горизонтальном направлении |
BottomLeft | Содержимое выравнивается по нижнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении |
BottomCenter | Содержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки |
BottomRight | Содержимое выравнивается по нижнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении |
ShowCellHints
Признак, определяющий, будут ли показываться всплывающие подсказки для ячеек таблицы.
Необязательный тэг. Значение тэга не ожидается.
По умолчанию используется значение False.
трибуты тэга <ShowCellHints>
<ShowCellHints>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
ColumnContextMenuBackColor
Цвет фона контекстного меню фильтрации и сортировки.
Необязательный тэг. Значение тэга не ожидается.
По умолчанию используется стандартное значение.
Атрибуты тэга <ColumnContextMenuBackColor>
<ColumnContextMenuBackColor>
Name | Название цвета. Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). |
ColumnContextMenuForeColor
Цвет шрифта контекстного меню фильтрации и сортировки.
Необязательный тэг. Значение тэга не ожидается.
По умолчанию используется стандартное значение.
Атрибуты тэга <ColumnContextMenuForeColor>
<ColumnContextMenuForeColor>
Name | Название цвета. Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). |
ColumnContextMenuWiden
Признак, определяющий, будет ли системное контекстное меню шире.
Необязательный тег. Значение тэга не ожидается.
По умолчанию используется значение False.
Атрибуты тэга <ColumnContextMenuWiden>
<ColumnContextMenuWiden>
Value | Значение. Обязательный атрибут. Ожидается логическое значение. |
Formatting
Условное форматирование ячеек таблицы на основе значений других ячеек таблицы в этой же строке.
Необязательный тэг. Значение тэга <Formatting>
: список тэгов <BackColor>
, <ForeColor>
и <FontStyle>
.
Тэг <BackColor>
<BackColor>
Условный цвет фона ячейки.
Необязательный тэг. Значение тэга <BackColor>
: не ожидается.
Атрибуты тэга <BackColor>
<BackColor>
Name | Значение. Необязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). |
Тэг <Color>
<Color>
Значение.
Необязательный тэг. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
Тэг <ColorFromColumnValue>
<ColorFromColumnValue>
Значение.
Необязательный тэг. Ожидается имя одного из столбцов таблицы, в котором записано название цвета или цвет в формате HTML (#rrggbb).
Значение цвета выбирается в следующем порядке:
Тэг <Columns>
<Columns>
Столбцы таблицы, для которых распространяется условное форматирование ячеек.
Необязательный тэг. Значение тэга <Columns>
: список тэгов <Column>
.
Если тэг <Columns>
отсутствует, то условное форматирование распространяется на все столбцы таблицы.
Тэг <Column>
<Column>
Столбец таблицы, для которого распространяется условное форматирование ячеек.
Необязательный тэг. Значение тэга <Column>
: не ожидается.
Атрибуты тэга <Column>
<Column>
Name | Значение. Обязательный атрибут. Ожидается название одного из столбцов таблицы. |
Тэг <Expression>
<Expression>
Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет.
Обязательный тэг. Значение тэга <Expression>
: любое значение.
Выражение для вычисления поддерживает выражения вида "ColumnName", где ColumnName - название одного из столбцов данной таблицы, и выражения вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т. д.
Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке "http://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression.aspx".
Тэг <Items>
<Items>
Переменные для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Items>
: список тэгов <Item>
.
Тэг <Item>
<Item>
Переменная для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Item>
: любое значение.
Тэг <ForeColor>
<ForeColor>
Условный цвет шрифта ячейки.
Необязательный тэг. Значение тэга <ForeColor>
: не ожидается.
Атрибуты тэга <ForeColor>
<ForeColor>
Name | Значение. Необязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). |
Тэг <Color>
<Color>
Значение.
Необязательный тэг. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
Тэг <ColorFromColumnValue>
<ColorFromColumnValue>
Значение.
Необязательный тэг. Ожидается имя одного из столбцов таблицы, в котором записано название цвета или цвет в формате HTML (#rrggbb).
Значение цвета выбирается в следующем порядке:
Тэг <Columns>
<Columns>
Столбцы таблицы, для которых распространяется условное форматирование ячеек.
Необязательный тэг. Значение тэга <Columns>
: список тэгов <Column>
.
Если тэг <Columns>
отсутствует, то условное форматирование распространяется на все столбцы таблицы.
Тэг <Column>
<Column>
Столбец таблицы, для которого распространяется условное форматирование ячеек.
Необязательный тэг. Значение тэга <Column>
: не ожидается.
Атрибуты тэга <Column>
<Column>
Name | Значение. Обязательный атрибут. Ожидается название одного из столбцов таблицы. |
Тэг <Expression>
<Expression>
Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет.
Обязательный тэг. Значение тэга <Expression>
: любое значение.
Выражение для вычисления поддерживает выражения вида "ColumnName", где ColumnName - название одного из столбцов данной таблицы, и выражения вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т. д.
Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке "http://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression.aspx".
Тэг <Items>
<Items>
Переменные для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Items>
: список тэгов <Item>
.
Тэг <Item>
<Item>
Переменная для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Item>
: любое значение.
Тэг <FontStyle>
<FontStyle>
Условный стиль шрифта ячейки.
Необязательный тэг. Значение тэга <FontStyle>
: не ожидается.
Атрибуты тэга <FontStyle>
<FontStyle>
Name | Значение. Обязательный атрибут. Ожидается имя одного из стилей шрифтов, описанных на форме. |
Тэг <Columns>
<Columns>
Столбцы таблицы, для которых распространяется условное форматирование ячеек.
Необязательный тэг. Значение тэга <Columns>
: список тэгов <Column>
.
Если тэг <Columns>
отсутствует, то условное форматирование распространяется на все столбцы таблицы.
Тэг <Column>
<Column>
Столбец таблицы, для которого распространяется условное форматирование ячеек.
Необязательный тэг. Значение тэга <Column>
: не ожидается.
Атрибуты тэга <Column>
<Column>
Name | Значение. Обязательный атрибут. Ожидается название одного из столбцов таблицы. |
Тэг <Expression>
<Expression>
Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет.
Обязательный тэг. Значение тэга <Expression>
: любое значение.
Выражение для вычисления поддерживает выражения вида "ColumnName", где ColumnName - название одного из столбцов данной таблицы, и выражения вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т. д.
Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке "http://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression.aspx".
Тэг <Items>
<Items>
Переменные для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Items>
: список тэгов <Item>
.
Тэг <Item>
<Item>
Переменная для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Item>
: любое значение.
SourceDataConnection
Загружающее соединение с данными, данные которого будут размещены в таблице.
Необязательный тэг. Значение тэга <SourceDataConnection>
: не ожидается.
Атрибуты тэга <SourceDataConnection>
<SourceDataConnection>
Name | Значение. Обязательный атрибут. Ожидается имя одного из загружающих соединений с данными, описанных на форме. |
Query | Значение. Необязательный атрибут. Ожидается имя одного из запросов загружающего соединения с данными, описанных на форме. |
SaveOnFormClose
Настройки сохранения информации о таблице. Признак, определяющий, будет ли сохранена информация о таблице.
Необязательный тэг. Значение тэга <SaveOnFormClose>
: не ожидается.
Если тэг <SaveOnFormClose>
отсутствует, то для атрибутов Columns
, Filter
и Sort
используются значения False, False, и False соответственно.
Атрибуты тэга <SaveOnFormClose>
<SaveOnFormClose>
Columns | Признак, определяющий, будет ли сохраняться информация о ширине, порядке, видимости столбцов таблицы. Для того, чтобы сохранить ширину столбцов у столбца в тэге Необязательный атрибут. Ожидается логическое значение. |
Filter | Признак, определяющий, будут ли сохраняться фильтры в таблице. Необязательный атрибут. Ожидается логическое значение. |
Sort | Признак, определяющий, будут ли сохраняться сортировки в таблице. Необязательный атрибут. Ожидается логическое значение. |
Columns
Список столбцов таблицы.
Обязательный тэг. Ожидается список тэгов <Column>
, содержащих описание столбцов.
Атрибуты столбцов DatabaseTable
Name | Название столбца (обязательно должно совпадать с именем поля, указанным в соединении с данными из тэга Обязательный атрибут. |
Type | Название типа столбца в сборке. Обязательный атрибут. |
Assembly | Название сборки (библиотека). Обязательный атрибут. |
Колонки таблицы могут быть одно из доступных типов:
DatabaseTableColumnTextBox - используется для отображения данных в виде текста;
DatabaseTableColumnComboBox - позволяет пользователям выбирать значение из выпадающего списка, если в таблице разрешено редактирование (тэг
<AllowUpdate>
имеет значение True);DatabaseTableColumnCheckBox - используется для отображения столбцов логических данных в виде CheckBox;
DatabaseTableColumnDateTimePicker - используется для отображения дат и времени в заданном формате и предоставляет пользователю возможностью выбирать значение в раскрывающемся календаре, если в таблице разрешено редактирование (тэг
<AllowUpdate>
имеет значение True);DatabaseTableColumnNumericBox - используется для отображения числовых значений и предоставляет пользователю возможностью задавать значение через NumericBox, если в таблице разрешено редактирование (тэг
<AllowUpdate>
имеет значение True).
Get-проперти для получения свойств
RowHeight
Возвращает высоту строк с данными в таблице.
ColumnHeadersHeight
Возвращает высоту "шапки" таблицы.
ColumnHeadersVisible
Возвращает признак, определяющий, показывать или нет "шапку" таблицы.
RowHeadersWidth
Возвращает ширину "нулевого" столбца таблицы.
RowHeadersVisible
Возвращает признак, определяющий, показывать или нет "нулевой" столбец таблицы.
BackgroundColor
Возвращает имя цвета фона таблицы.
BorderStyle
Возвращает название типа границ таблицы.
CellBorderStyle
Возвращает название стиля границ ячеек в таблице.
HideSelection
Возвращает признак видимости выделения в таблице.
AllowInsert
Возвращает признак, определяющий, может ли пользователь добавлять строки в таблицу посредством графического интерфейса таблицы.
AllowUpdate
Возвращает признак, определяющий, может ли пользователь изменять значения в строках таблицы посредством графического интерфейса таблицы.
AllowDelete
Возвращает признак, определяющий, может ли пользователь удалять строки из таблицы посредством графического интерфейса таблицы.
MultiSelect
Возвращает признак, определяющий, можно ли выделить в таблице более одной строки одновременно.
SelectionMode
Возвращает название типа выделения таблицы.
EditMode
Возвращает название типа редактирования ячеек таблицы.
AllowResizeColumns
Возвращает признак, определяющий, может ли пользователь изменять ширину столбцов посредством графического интерфейса таблицы.
AllowOrderColumns
Возвращает признак, определяющий, может ли пользователь изменять порядок отображения столбцов посредством графического интерфейса таблицы.
AllowResizeRows
Возвращает признак, определяющий, может ли пользователь изменять высоту строк посредством графического интерфейса таблицы.
AutoSizeRowsMode
Возвращает название типа автоматического изменения высот строк таблицы.
Column
Возвращает линейный массив значений, содержащихся в определенном столбце таблицы.
ColumnUniqueValues
Возвращает линейный массив уникальных значений, содержащихся в определенном столбце таблицы.
ColumnTitle
Возвращает название столбца таблицы по имени столбца.
ColumnHint
Возвращает текст подсказки, всплывающей на заголовке столбца таблицы, по имени столбца.
ColumnLeft
Возвращает координату по горизонтали для определенного столбца таблицы, относительно того объекта, где расположена таблица (без учёта полосы горизонтальной прокрутки).
ColumnOffset
Возвращает координату по горизонтали для определенного столбца таблицы, относительно того объекта, где расположена таблица (с учётом положения полосы горизонтальной прокрутки).
ColumnVisible
Возвращает видимость столбца.
ColumnDisplayIndex
Возвращает порядок отображения определенного столбца таблицы.
ColumnWidth
Возвращает ширину определенного столбца таблицы.
ColumnSum
Возвращает сумму значений всех ячеек в определенном столбце таблицы.
ColumnHeaderCheckBoxState
Возвращает текущее состояние CheckBox в заголовке определенного столбца таблицы.
CountingSumMultiply
Возвращает сумму, состоящую из произведений значений ячеек из двух определенных столбцов.
CountingSignSumMultiply
Возвращает сумму, состоящую из определенных произведений значений ячеек из двух определенных столбцов.
Признаком для включения произведения строки в общую сумму служит значение ячейки третьего столбца.
SelectedRowIndex
Возвращает номер первой выделенной строки таблицы. Если строка таблицы не выбрана, то get-проперти вернет значение -1.
SelectedRowsIndices
Возвращает линейный массив индексов выделенных строк таблицы.
SelectedColumnName
Возвращает название столбца выделенной ячейки таблицы.
SelectedCellValue
Возвращает значение выделенной ячейки таблицы.
SelectedRowsCount
Возвращает количество выделенных строк в таблице.
SelectedCellsSumByColumnName
Возвращает сумму значений выделенных ячеек в определенном столбце таблицы.
SelectedRowCellValueByColumnName
Возвращает значение ячейки определенного столбца выделенной строки таблицы.
SelectedRowsCellValuesByColumnName
Возвращает линейный массив значений ячеек столбца ColumnName выделенных строк таблицы.
RowsCount
Возвращает количество строк в таблице.
RowIndexOf
Возвращает индекс строки, удовлетворяющей условиям соответствия названий столбцов и значений в этих столбцах.
RowsIndicesOf
Возвращает массив индексов строки, удовлетворяющих условиям соответствия названий столбцов и значений в этих столбцах.
При установке параметра SearchWithArrays поиск для каждого столбца будет вестись по значениям из переданного для него массива по такому принципу, чтобы очередное значение из таблицы совпадало хотя бы с одним значением из этого массива.
ValueByAnotherFieldValue
Возвращает значение ячейки одного столбца в строке, найденной по определенному значению другого столбца.
Data
Возвращает двумерную матрицу элементов с именованными столбцами, содержащую значения всех ячеек таблицы, удовлетворяющую выражению фильтра.
Все поддерживаемые в выражении фильтра конструкции смотрите по ссылке.
ArrayData
Возвращает двумерную матрицу элементов, содержащую значения всех ячеек таблицы.
DictionaryArrayData
Возвращает массив словарей, содержащих значения всех ячеек таблицы.
FilteredColumnValues
Возвращает массив элементов определенного столбца ColumnName, выбранных на основе выражения Filter, задающего фильтрацию строк таблицы.
RowAdded
Возвращает признак, была ли строка с определенным индексом сохранена в базе данных.
SortedColumn
Возвращает название столбца, по которому пользователь отсортировал таблицу.
SortDirection
Возвращает направление сортировки столбца, по которому пользователь отсортировал таблицу.
Направления сортировки столбца
ASC | По возрастанию |
DESC | По убыванию |
NULL | Нет пользовательской сортировки |
VerticalScrollOffset
Возвращает величину смещения полосы вертикальной прокрутки таблицы в пикселях.
HorizontalScrollOffset
Возвращает величину смещения полосы горизонтальной прокрутки таблицы в пикселях.
LastCellClickedRowIndex
Возвращает индекс строки, по ячейке которой был совершен последний клик (значение обновляется после события Click, но до события CellClick).
LastCellClickedColumnName
Возвращает название столбца, по ячейке которого был совершен последний клик (значение обновляется после события Click, но до события CellClick).
LastCellDoubleClickedRowIndex
Возвращает индекс строки, по ячейке которой был совершен последний двойной клик (значение обновляется после события DoubleClick, но до события CellDoubleClick).
LastCellDoubleClickedColumnName
Возвращает название столбца, по ячейке которого был совершен последний двойной клик (значение обновляется после события DoubleClick, но до события CellDoubleClick).
LastCellValueChangedRowIndex
Возвращает индекс строки, ячейка которой была изменена последней (значение обновляется до события CellValueChanged).
LastCellValueChangedColumnName
Возвращает название столбца, ячейка которого была изменена последней (значение обновляется до события CellValueChanged).
CellValue
Возвращает значение ячейки по индексу строки RowIndex и названию столбца ColumnName.
ColumnMinimumWidth
Возвращает минимальную ширину определенного столбца таблицы.
Set-проперти для динамического задания свойств
RowHeight
Задает высоту строк с данными в таблице.
Ожидается целочисленное значение.
ColumnHeadersHeight
Задает высоту "шапки" таблицы.
Ожидается целочисленное значение.
ColumnHeadersVisible
Задает признак, определяющий, показывать или нет "шапку" таблицы.
Ожидается логическое значение.
RowHeadersWidth
Задает ширину "нулевого" столбца таблицы.
Ожидается целочисленное значение.
RowHeadersVisible
Задает признак, определяющий, показывать или нет "нулевой" столбец таблицы.
Ожидается логическое значение.
BackgroundColor
Задает имя цвета фона таблицы.
Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
BorderStyle
Задает название типа границ таблицы.
Ожидается название одного из типов границ таблицы.
CellBorderStyle
Задает название стиля границ ячеек в таблице.
Ожидается название одного из стилей границ ячеек в таблице.
HideSelection
Задает признак видимости выделения в таблице.
Ожидается логическое значение.
AllowInsert
Задает признак, определяющий, может ли пользователь добавлять строки в таблицу посредством графического интерфейса таблицы.
Ожидается логическое значение.
AllowUpdate
Задает признак, определяющий, может ли пользователь изменять значения в строках таблицы посредством графического интерфейса таблицы.
Ожидается логическое значение.
AllowDelete
Задает признак, определяющий, может ли пользователь удалять строки из таблицы посредством графического интерфейса таблицы.
Ожидается логическое значение.
MultiSelect
Задает признак, определяющий, можно ли выделить в таблице более одной строки одновременно.
Ожидается логическое значение.
SelectionMode
Задает название типа выделения таблицы.
Ожидается название одного из типов выделения таблицы.
EditMode
Задает название типа редактирования ячеек таблицы.
Ожидается название одного из типов редактирования ячеек таблицы.
AllowResizeColumns
Задает признак, определяющий, может ли пользователь изменять ширину столбцов посредством графического интерфейса таблицы.
Ожидается логическое значение.
AllowOrderColumns
Задает признак, определяющий, может ли пользователь изменять порядок столбцов посредством графического интерфейса таблицы.
Ожидается логическое значение.
AllowResizeRows
Задает признак, определяющий, может ли пользователь изменять высоту строк посредством графического интерфейса таблицы.
Ожидается логическое значение.
AutoSizeRowsMode
Задает название типа автоматического изменения высот строк таблицы.
Ожидается название одного из типов автоматического изменения высот строк таблицы.
ColumnTitle
Задает название <Title>
для столбца ColumnName таблицы.
ColumnHint
Задает текст подсказки <Hint>
, всплывающей на заголовке столбца таблицы, для столбца ColumnName таблицы.
ColumnDisplayIndex
Задает порядок отображения <DisplayIndex>
для столбца ColumnName таблицы.
ColumnWidth
Задает ширину <Width>
для столбца ColumnName таблицы.
SelectedRowIndex
Задает выделенную строку таблицы по индексу, показывая выделенную строку первой.
Ожидается целочисленное значение.
SelectedRowsIndices
Задает выделенные строки таблицы по индексам.
Ожидается линейный массив целочисленных значений.
SelectedColumnName
Задает выделенный столбец таблицы по имени.
Ожидается название одного из столбцов таблицы.
SelectedCellValue
Задает значение выделенной ячейки таблицы.
Ожидается любое значение.
SelectCell
Выделяет ячейку по индексу строки и имени столбца.
SelectRowByFieldValue
Выделяет первую строку таблицы, для которой значение, указанное в столбце ColumnName, совпадает с одним из значений, указанных в параметре Value.
SelectRowsByFieldValue
Выделяет строки таблицы, для которых значений, указанные в столбце ColumnName, совпадают с одним из значений, указанных в параметре Value.
AutoSize
Единоразово устанавливает ширину и высоту таблицы, сворачивая или разворачивая её таким образом, чтобы в зоне видимости оказались все её строки и столбцы без полос прокрутки.
Значение не ожидается.
AddRow
Добавляет новую строку в таблицу со значениями Values, соответствующим столбцам ColumnNames, на место с индексом Index и выделяет ее в соответствии с признаком SelectAfterAdd, при этом снимая выделение с остальных строк в соответствии с признаком ClearOtherSelection.
AddRows
Добавляет новые строки в таблицу со значениями из таблицы Values, столбцы которой соответствуют столбцам ColumnNames, на места начиная с индекса Index и выделяя их (или первую из них - при значении тэга<MultiSelect>
равного False) в соответствии с признаком SelectAfterAdd, при этом выделение остальных строк снимается в соответствии с признаком ClearOtherSelection.
UpdateRow
Изменяет значения столбцов ColumnNames на значения Values, соответствующим столбцам ColumnNames, в строке с индексом RowIndex.
UpdateRows
Изменяет значения столбцов ColumnNames на значения Values, соответствующим столбцам ColumnNames, в строках с индексами RowIndices.
UpdateColumn
Построчно изменяет значения ячеек в столбце ColumnName на соответствующие значения массива Values.
UpdateColumnCellsValues
Изменяет значения ячеек в строках с индексами RowsIndices в столбце ColumnName на значение Value.
DeleteRowsByIndices
Удаляет строки с индексами Value из таблицы.
ColumnMinimumWidth
Задает минимальную ширину <MinimumWidth>
для столбца ColumnName таблицы.
ClearSelection
Снимает выделение со всех строк таблицы.
Значение не ожидается.
ResetFilter
Принудительно сбрасывает все табличные фильтры, которые были заданы через контекстное меню таблицы.
Значение не ожидается.
Last updated