Язык программирования 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()
{
// Получить первую запись на основе порядка в базе данных.
<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()
(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390}){
// Получить первую запись на основе порядка "фамилия, имя".
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);
