Язык программирования 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()
 
{
  // Получить первую запись на основе порядка &quot;фамилия, имя&quot;.
  var customer = Context.Customers
<b>      .OrderBy(x =&gt; x.PersonalInformation.LastName)</b>
<b>      .ThenBy(x =&gt; 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&lt;InvalidOperationException&gt;(()</b>
<b>    =&gt; Context.Customers.First(x =&gt; 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&lt;Func&lt;Customer&gt;&gt; - это лямбда-выражение.
  Expression&lt;Func&lt;Customer, bool&gt;&gt; expression = x =&gt; x.Id == 10;
  // Возвращает null, если ничего не найдено.
<b>  var customer = Context.Customers.FirstOrDefault(expression);</b>
  Assert.Null(customer);