Функция 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 — необязательный аргумент. Имя столбца, для которого нужно получить информацию на уровне столбца. Для сведений на уровне источника данных аргумент ColumnName не может использоваться.
Заметка
В Power Apps до версии 3.24042 имена столбцов задавались текстовой строкой с использованием двойных кавычек, а при подключении к источнику данных они также должны были быть логическими именами. Например, вместо отображаемого имени Имя без кавычек использовалось логическое имя "cr43e_name" в двойных кавычках. Для источников данных 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 |