Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен
• Метод 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()
{
// Получить первую запись на основе порядка в базе данных.
var customer = Context.Customers.First();
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
.OrderBy(x => x.PersonalInformation.LastName)
.ThenBy(x => x.PersonalInformation.FirstName)
.First();
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.
// Сгенерировать исключение, если соответствие не найдено.
Assert.Throws<InvalidOperationException>(()
=> Context.Customers.First(x => x.Id == 10));
}
Предыдущий запрос 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, если ничего не найдено.
var customer = Context.Customers.FirstOrDefault(expression);
Assert.Null(customer);
}
Предыдущий запрос LINQ транслируется в тот же код SQL, что и ранее:
SELECT TOP(1) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName] FROM [Dbo].[Customers] AS [c]
WHERE [c].[Id] = 10
Использование Last()/LastOrDefault()
При использовании формы Last() и LastOrDefault() без параметров будет возвращаться последняя запись (на основе предшествующих конструкций упорядочения). Показанный далее тест получает последнюю запись на основе порядка "фамилия, имя":
[Fact]
public void GetLastMatchingRecordNameOrder()
{
// Получить последнюю запись на основе порядка "фамилия, имя".
var customer = Context.Customers
.OrderBy(x => x.PersonalInformation.LastName)
.ThenBy(x => x.PersonalInformation.FirstName)
.Last();
Assert.Equal(4, customer.Id);
}
Инфраструктура EF Core инвертирует операторы ORDER BY и затем получает результат с помощью ТОР(1). Вот как выглядит выполняемый запрос:
SELECT TOP(1) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName] FROM [Dbo].[Customers] AS [c]
ORDER BY [c].[LastName] DESC, [c].[FirstName] DESC
Использование Single()/SingleOrDefault()
Концептуально Single()/SingleOrDefault() работает аналогично First()/FirstOrDefault(). Основное отличие в том, что метод Single()/SingleOrDefault() возвращает TOP(2), а не ТОР(1), и генерирует исключение, если из базы данных возвращаются две записи. Следующий тест извлекает одиночную запись, в которой значение Id равно 1:
[Fact]
public void GetOneMatchingRecordWithSingle()
{
// Получить первую запись на основе порядка в базе данных.
var customer = Context.Customers.Single(x => x.Id == 1);
Assert.Equal(1, customer.Id);
}
Предыдущий запрос LINQ транслируется в такой код SQL:
SELECT TOP(2) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName] FROM [Dbo].[Customers] AS [c]
WHERE [c].[Id] = 1
Если запись не возвращается, тогда метод Single() генерирует исключение:
[Fact]
public void SingleShouldThrowExceptionIfNoneMatch()
{
// Фильтровать на основе Id.
// Сгенерировать исключение, если соответствие не найдено.
Assert.Throws<InvalidOperationException>(()
=> Context.Customers.Single(x => x.Id == 10));
}
Предыдущий запрос LINQ транслируется в такой код SQL:
SELECT TOP(2) [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],
[c].[LastName] FROM [Dbo].[Customers] AS [c]
WHERE [c].[Id] = 10
Если при использовании Single() или SingleOrDefault() возвращается больше чем одна запись, тогда генерируется исключение:
[Fact]
public void SingleShouldThrowExceptionIfMoreThenOneMatch()
{
// Сгенерировать исключение, если найдено более одного соответствия.
Assert.Throws<InvalidOperationException>(()
=> Context.Customers.Single());
}
[Fact]
public void SingleOrDefaultShouldThrowExceptionIfMoreThenOneMatch()
{
// Сгенерировать исключение, если найдено более одного соответствия.
Assert.Throws<InvalidOperationException>(()
