• Метод
Single()
возвращает первую запись, которая соответствует условию запроса и любым конструкциям упорядочения. Если конструкции упорядочения не указаны, то возвращаемая запись основывается на порядке, установленном в базе данных. Если запросу не соответствует одна или большее число записей, тогда генерируется исключение.
• Поведение метода
SingleOrDefault()
совпадает с поведением
Single()
, но при отсутствии записей, соответствующих запросу,
SingleOrDefault()
возвращает стандартное значение для типа (
null
).
• Метод
Last()
возвращает последнюю запись, которая соответствует условию запроса и любым конструкциям упорядочения. Если конструкции упорядочения не указаны, то возвращаемая запись основывается на порядке, установленном в базе данных. Если запись не возвращается, тогда генерируется исключение.
• Поведение метода
LastOrDefault()
совпадает с поведением
Last()
, но при отсутствии записей, соответствующих запросу,
LastOrDefault()
возвращает стандартное значение для типа (
null
).
Все методы могут также принимать
Expression<Func<T, bool>>
(лямбда-выражение) для фильтрации результирующего набора. Это означает, что вы можете помещать выражение
Where()
внутрь вызова
First()/Single()
. Следующие операторы эквивалентны:
Context.Customers.Where(c=>c.Id < 5).First();
Context.Customers.First(c=>c.Id < 5);
Из-за немедленного выполнения операторов LINQ, извлекающих одиночную запись, метод
ToQueryString()
оказывается недоступным. Приводимые трансляции запросов в код SQL получены с применением профилировщика SQL Server.
Использование First()/FirstOrDefault()
При использовании формы
First()
и
FirstOrDefault()
без параметров будет возвращаться первая запись (на основе порядка в базе данных или предшествующих конструкций упорядочения).
Показанный далее тест получает первую запись на основе порядка в базе данных:
[Fact]
public void GetFirstMatchingRecordDatabaseOrder()
{
// Получить первую запись на основе порядка в базе данных.
<b> var customer = Context.Customers.First();</b>
Assert.Equal(1, customer.Id);
}
Предыдущий запрос LINQ транслируется в такой код SQL:
SELECT TOP(1) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName]
FROM [Dbo].[Customers] AS [c]
Следующий тест получает первую запись на основе порядка "фамилия, имя":
[Fact]
public void GetFirstMatchingRecordNameOrder()
{
// Получить первую запись на основе порядка "фамилия, имя".
var customer = Context.Customers
<b> .OrderBy(x => x.PersonalInformation.LastName)</b>
<b> .ThenBy(x => x.PersonalInformation.FirstName)</b>
<b> .First();</b>
Assert.Equal(1, customer.Id);
}
Предыдущий запрос LINQ транслируется в такой код SQL:
SELECT TOP(1) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName]
FROM [Dbo].[Customers] AS [c]
ORDER BY [c].[LastName], [c].[FirstName]
Приведенный ниже тест выдвигает утверждение о том, что если для
First()
не найдено соответствие, тогда генерируется исключение:
[Fact]
public void FirstShouldThrowExceptionIfNoneMatch()
{
// Фильтровать на основе Id.
// Сгенерировать исключение, если соответствие не найдено.
<b> Assert.Throws<InvalidOperationException>(()</b>
<b> => Context.Customers.First(x => x.Id == 10));</b>
}
Предыдущий запрос LINQ транслируется в такой код SQL:
SELECT TOP(1) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName]
FROM [Dbo].[Customers] AS [c]
WHERE [c].[Id] = 10
На заметку!
Assert.Throws()
— это специальный тип утверждения, который ожидает, что код в выражении сгенерирует исключение. Если исключение не было сгенерировано, тогда утверждение терпит неудачу.
В случае применения метода
FirstOrDefault()
, если соответствие не найдено, то результатом будет null, а не исключение:
[Fact]
public void FirstOrDefaultShouldReturnDefaultIfNoneMatch()
{
// Expression<Func<Customer>> - это лямбда-выражение.
Expression<Func<Customer, bool>> expression = x => x.Id == 10;
// Возвращает null, если ничего не найдено.
<b> var customer = Context.Customers.FirstOrDefault(expression);</b>
Assert.Null(customer);
