Функция DataSourceInfo

Применимо к: приложениям на основе холста приложениям на основе модели

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

Обзор

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

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

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

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

Заметка

В настоящее время функция DataSourceInfo не поддерживается в Microsoft Списки.

Описание

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

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

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

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

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

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

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

Заметка

DataSourceInfo возвращает истина, если он не может определить, есть ли у текущего пользователя запрошенное разрешение. Разрешения будут снова проверяться сервером при выполнении фактической операции, и отображается ошибка, если она не была разрешена. В настоящее время проверка разрешений с помощью DataSourceInfo возможна только при использовании Microsoft Dataverse.

Синтаксис

DataSourceInfo( DataSource, Information, ColumnName )

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

  • Information — обязательный аргумент. Тип сведений, которые требуется получить.

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

    Заметка

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

Примеры

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

Пример 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