Содержит сведения об источнике данных.

Обзор

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

Перед применением функции Patch можно использовать сведения на уровне столбца, чтобы проверить данные, вводимые пользователем, и немедленно предоставить пользователю обратную связь. Функция Validate использует эти же сведения.

Сведения на уровне источника данных можно использовать, например, для отключения или скрытия от пользователей кнопок Изменить и Создать, если у этих пользователей нет разрешений на изменение и создание записей.

Источники данных различаются по объему предоставляемых сведений, включая возможность не предоставлять их совсем. Коллекции не предоставляют сведений. Если не предоставляется часть сведений, то используется значение по умолчанию или возвращается значение blank (пусто).

Описание

Сведения о столбце

Функцию DataSourceInfo можно использовать для получения сведений о конкретном столбце источника данных:

Аргумент сведений Тип результата Описание
DataSourceInfo.DisplayName Строка Отображаемое имя столбца. Если отображаемое имя не определяется, то возвращается имя столбца.
DataSourceInfo.MaxLength Номер Максимальное количество знаков, которое может содержать столбец. Применимо только к столбцам, содержащим строки. Если максимальное значение не задано, то возвращается значение blank (пусто).
DataSourceInfo.MaxValue Номер Максимальное числовое значение, которое может содержать столбец. Применимо только к столбцам, содержащим числа. Если максимальное значение не задано, то возвращается значение blank (пусто).
DataSourceInfo.MinValue Номер Минимальное числовое значение, которое может содержать столбец. Применимо только к столбцам, содержащим числа. Если минимальное значение не задано, то возвращается значение blank (пусто).
DataSourceInfo.Required Логическое значение Требуется ли значение для этого столбца? Если значение не задано источником данных, то возвращается ответ false.

Третий аргумент — это имя столбца в виде строки. Например, столбец Phone в коллекции People будет передаваться как "Phone" (включая двойные кавычки).

Сведения об источнике данных

Функцию DataSourceInfo можно также использовать для получения сведений об источнике данных в целом:

Аргумент сведений Тип результата Описание
DataSourceInfo.AllowedValues Логическое значение Какие разрешения для этого источника данных могут предоставляться пользователям? Если значение не задано источником данных, то возвращается пустой ответ.
DataSourceInfo.CreatePermission Логическое значение Имеет ли текущий пользователь разрешение на создание записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.
DataSourceInfo.DeletePermission Логическое значение Имеет ли текущий пользователь разрешение на удаление записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.
DataSourceInfo.EditPermission Логическое значение Имеет ли текущий пользователь разрешение на изменение записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.
DataSourceInfo.ReadPermission Логическое значение Имеет ли текущий пользователь разрешение на чтение записей в этом источнике данных? Если значение не задано источником данных, то возвращается ответ true.

Синтаксис

DataSourceInfo( Источник_данных, Сведения, Имя_столбца )

  • Источник_данных — обязательный аргумент. Источник данных, который необходимо использовать.
  • Сведения — обязательный аргумент. Тип сведений, которые требуется получить.
  • Имя_столбца — необязательный аргумент. Для сведений на уровне столбца это имя столбца в виде строки. Столбец Phone будет передаваться как "Phone" (включая двойные кавычки). Для сведений на уровне источника данных аргумент ColumnName не может использоваться.

    Примечание. Для источников данных SharePoint и Excel, содержащих имена столбцов с пробелами, вместо каждого пробела укажите "_x0020_". Например, Имя столбца укажите как Имя_x0020_столбца.

Примеры

Примеры в этом разделе используют следующий источник данных с именем IceCream:

Источник данных также предоставил такие сведения:

  • Отображаемое имя для столбца Quantity — "Quantity on Hand" (Количество в наличии).
  • Максимальная длина значений в столбце Flavor — 30 знаков.
  • Столбец Flavor должен содержать значение. Столбец Quantity является необязательным.
  • Минимальное значение для Quantity — 0.
  • Максимальное значение для Quantity — 100.
  • Текущий пользователь может просматривать и изменять записи в источнике данных IceCream, но не может их создавать или удалять.
Формула Описание Возвращаемый результат
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Возвращает отображаемое имя для столбца Quantity источника данных IceCream. "Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Возвращает максимальную длину строки для столбца Flavor источника данных IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) Является ли столбец Flavor источника данных IceCream обязательным? true
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) Является ли столбец Quantity источника данных IceCream обязательным? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Возвращает максимальное числовое значение для столбца Quantity источника данных IceCream. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Возвращает минимальное числовое значение для столбца Quantity источника данных IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Может ли текущий пользователь просматривать записи в источнике данных IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Может ли текущий пользователь изменять записи в источнике данных IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Может ли текущий пользователь создавать записи в источнике данных IceCream? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Может ли текущий пользователь удалять записи в источнике данных IceCream? false