Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю

На нашем сайте KnigaRead.com Вы можете абсолютно бесплатно читать книгу онлайн Троелсен Эндрю, "Язык программирования C#9 и платформа .NET5" бесплатно, без регистрации.

Назад 1 ... 459 460 461 462 463 ... 642 Вперед

Перейти на страницу:

• Метод

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