• Поведение метода FirstOrDefault совпадает с поведением First, но при отсутствии записей, соответствующих запросу, FirstOrDefault возвращает стандартное значение для типа (null).
• Метод Single возвращает первую запись, которая соответствует условию запроса и любым конструкциям упорядочения. Если конструкции упорядочения не указаны, то возвращаемая запись основывается на порядке, установленном в базе данных. Если запросу не соответствует одна или большее число записей, тогда генерируется исключение.
• Поведение метода SingleOrDefault совпадает с поведением Single, но при отсутствии записей, соответствующих запросу, SingleOrDefault возвращает стандартное значение для типа (null).
• Метод Last возвращает последнюю запись, которая соответствует условию запроса и любым конструкциям упорядочения. Если конструкции упорядочения не указаны, то возвращаемая запись основывается на порядке, установленном в базе данных. Если запись не возвращается, тогда генерируется исключение.
• Поведение метода LastOrDefault совпадает с поведением Last, но при отсутствии записей, соответствующих запросу, LastOrDefault возвращает стандартное значение для типа (null).
Все методы могут также принимать Expression (лямбда-выражение) для фильтрации результирующего набора. Это означает, что вы можете помещать выражение 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 без параметров будет возвращаться первая запись (на основе порядка в базе данных или предшествующих конструкций упорядочения).
Показанный далее тест получает первую запись на основе порядка в базе данных:
[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
=> 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 — это специальный тип утверждения, который ожидает, что код в выражении сгенерирует исключение. Если исключение не было сгенерировано, тогда утверждение терпит неудачу.
