Для отображения списка сущностей с возможностью выбора записей используйте методы ShowSelect() – пользователь может выбрать одну запись в списке, ShowSelectMany() – пользователь может выбрать несколько записей в списке.

Метод ShowSelectMany() может возвращать список выбранных сущностей или запрос на их получение. Для оптимизации работы с большими модальными списками рекомендуется использовать метод для получения запроса на выбранные сущности.

ShowSelect()

Перегрузки

Синтаксис

Параметры

title – дополнительный заголовок списка;

searchText – строка, по которой будет установлен фильтр для списка сущностей. Значение строки будет отображаться в быстром поиске.

Возвращаемое значение

Выбранная сущность. Если сущность не выбрана, то значение null.

Пример 1. Показ формы выбора одной сущности

// Показать форму списка сущностей типа IEmployee (список сотрудников) в режиме выбора.

var selectedEmployee = employeeList.ShowSelect();

В переменной selectedEmployee будет находиться выбранная запись сотрудника или значение null, если запись не выбрана.

Пример 2. Показ списка всех отчетов

public virtual void ShowAllReports()

{

  var reports = RecordManagement.Reports.GetAll()

    .Where(r => !(r is RecordManagement.IAcquaintanceReport))

    .ToList();

  reports.Add(Docflow.Reports.GetSkippedNumbersReport());

  reports.AsEnumerable().ShowSelect(RecordManagement.Resources.AllReportsTitle);

}

ShowSelectMany()

Перегрузки

Синтаксис

Параметры

title – дополнительный заголовок списка;

searchText – строка, по которой будет установлен фильтр для списка сущностей. Значение строки будет отображаться в быстром поиске.

Возвращаемое значение

В зависимости от вызова метода возвращается:

•список выбранных сущностей. Если сущности не выбраны, возвращается пустой список;

•запрос на получение выбранных сущностей. Если сущности не выбраны, возвращается запрос на пустой список.

Пример 1. Показ формы для выбора одной или нескольких сущностей с возвратом запроса на выбранные сущности

// Получить запрос на список выбранных сущностей.

var query = Employees.GetAll().ShowSelectMany();
// Получить сущности.
var selectedEmployees = query.ToList();
// Получить ИД сущностей.
var selectedIds = query.Select(e => e.Id).ToList(); 
// Получить ИД и имена сущностей.
var selectedProperties = query.Select(e => new { e.Id, e.Name }).ToList();

Результат вызова ShowSelectMany() – это запрос, который при выполнении вернет список выбранных сущностей. В переменной selectedProperties будет находиться список идентификаторов и имен выбранных записей сотрудников (IEnumerable<IEmployee>) или пустой список, если ни одна запись не выбрана.

Пример 2. Показ формы выбора одной или нескольких сущностей с получением списка сущностей

// Создать массив сотрудников.

var employees = new [] { employee1, employee2, employee3 };
// Получить список выбранных сущностей, например, new [] { employee1, employee2 }.
var selectedEmployees = employees.ShowSelectMany();

СМ. ТАКЖЕ

© Компания Directum, 2024