Чтобы ускорить обработку связанных документов, вместо устаревших методов GetRelated() и GetRelatedFrom() с типом возвращаемого значения IEnumerable<T> используйте методы GetRelatedDocuments() и GetRelatedFromDocuments(). Они возвращают значение с типом IQueryable<T>.

Пример кода без оптимизации

.GetRelated(relationType).Where(l => OfficialDocuments.As(l)?.LeadingDocument != document);

Пример оптимального кода

.GetRelatedDocuments(relationType).Where(l => OfficialDocuments.Is(l) && OfficialDocuments.As(l).LeadingDocument != document);

Некоторые запросы с методами GetRelatedDocuments() и GetRelatedFromDocuments() не поддерживаются. Например, если в запросе используется конструкция, которую нельзя преобразовать в SQL. В этом случае после вызова методов добавьте расширения ToList() или ToArray(). Такой код будет работать без оптимизации.

Пример кода, который не преобразуется в SQL

someDocument.GetRelated().Where(d => SomeFunction(d));

Пример доработки кода с использованием ToList()

someDocument.GetRelatedDocuments().ToList().Where(d => SomeFunction(d));

Вместо совместного вызова методов GetRelatedDocuments() и GetRelatedFromDocuments() используйте метод GetRelatedAndRelatedFromDocuments().

Пример кода без оптимизации

document.Relations.GetRelated().Union(document.Relations.GetRelatedFrom()).Distinct();

Пример оптимального кода

document.Relations.GetRelatedAndRelatedFromDocuments();

Если нужны данные о связях документа, а не сами документы, то используйте репозиторий связей DocumentRelations.

Пример кода без оптимизации

var docsWithRelations = ElectronicDocuments.GetAll().ToList().Where(d => d.Relations.GetRelated().Any()).ToList();

Пример оптимального кода

var docsWithRelations = ElectronicDocuments.GetAll().Where(d => DocumentRelations.GetAll().Any(r => r.Source.Equals(d)).ToList();

В циклах и повторяемых выражениях не используйте методы GetRelatedDocuments() и GetRelatedFromDocuments() с одинаковыми параметрами для одних и тех же документов. Иначе метод получает связанные документы при каждом вызове. Вместо этого рекомендуется получать список связанных документов только один раз, а затем обращаться к нему.

Созданные связи, которых еще нет в базе данных, учитываются при вызове методов GetRelatedDocuments() и GetRelatedFromDocuments(). Для этого в них замыкаются запросы на получение данных. Чтобы этого не происходило, методы нужно использовать после сохранения связей. В результате запросы не замыкаются, и их можно дофильтровать в прикладном коде.

Не рекомендуется без необходимости получать связанные документы целиком, если нужны только некоторые их свойства. Вместо этого используйте ограниченную выборку. Таким образом SQL-запросы к сущностям становятся проще и выполняются быстрее, при этом можно избежать сканирования таблиц. Также это справедливо не только для связей, но и для любых запросов к сущностям.

Пример оптимального кода для запроса одного параметра

GetRelatedDocuments().Select(d => d.SomeProperty));

Пример оптимального кода для запроса нескольких параметров

// Получить информацию обо всех связанных документах.

var relatedInfo = electronicDocument.Relations.GetRelatedAndRelatedFromDocuments().Select(d => new DocumentInfo() { Id = d.Id, Name = d.Name }).ToList();