• Поведение метода 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

При использовании формы 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 — это специальный тип утверждения, который ожидает, что код в выражении сгенерирует исключение. Если исключение не было сгенерировано, тогда утверждение терпит неудачу.