Язык программирования C#9 и платформа .NET5

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(()

    => 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> - это лямбда-выражение.

  Expression> 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()

{