Язык программирования 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>(()