Queryable.DefaultIfEmpty Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.Queryable.dll

Возвращает элементы последовательности или одноэлементную коллекцию со значением по умолчанию, если последовательность пуста.

Перегрузки

DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource)	Возвращает элементы указанной последовательности или одноэлементную коллекцию, содержащую указанное значение, если последовательность пуста.
DefaultIfEmpty<TSource>(IQueryable<TSource>)	Возвращает элементы указанной последовательности или одноэлементную коллекцию, содержащую значение параметра типа по умолчанию, если последовательность пуста.

DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource)

Исходный код:

Queryable.cs

Возвращает элементы указанной последовательности или одноэлементную коллекцию, содержащую указанное значение, если последовательность пуста.

C#

public static System.Linq.IQueryable<TSource> DefaultIfEmpty<TSource> (this System.Linq.IQueryable<TSource> source, TSource defaultValue);

Параметры типа

TSource

Тип элементов source.

Параметры

source

IQueryable<TSource>

Объект IQueryable<T>, для которого возвращается указанное значение, если последовательность пуста.

defaultValue

TSource

Значение, возвращаемое в случае пустой последовательности.

Возвращаемое значение

IQueryable<TSource>

Объект IQueryable<T>, содержащий значение defaultValue, если последовательность source пуста; в противном случае возвращается source.

Исключения

ArgumentNullException

source имеет значение null.

Примеры

В следующем примере кода показана ситуация, в которой полезно вызывать DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) в запросе LINQ. В этом примере передается значение по умолчанию DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) .

C#

// Create a list of Pet objects.
List<Pet> pets =
    new List<Pet>{ new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };

// This query selects only those pets that are 10 or older.
// In case there are no pets that meet that criteria, call
// DefaultIfEmpty(). This code passes an (optional) default
// value to DefaultIfEmpty().
string[] oldPets =
    pets.AsQueryable()
    .Where(pet => pet.Age >= 10)
    .Select(pet => pet.Name)
    .DefaultIfEmpty("[EMPTY]")
    .ToArray();

Console.WriteLine("First query: " + oldPets[0]);

// This query selects only those pets that are 10 or older.
// This code does not call DefaultIfEmpty().
string[] oldPets2 =
    pets.AsQueryable()
    .Where(pet => pet.Age >= 10)
    .Select(pet => pet.Name)
    .ToArray();

// There may be no elements in the array, so directly
// accessing element 0 may throw an exception.
try
{
    Console.WriteLine("Second query: " + oldPets2[0]);
}
catch (Exception e)
{
    Console.WriteLine("Second query: An exception was thrown: " + e.Message);
}

/*
    This code produces the following output:

    First query: [EMPTY]
    Second query: An exception was thrown: Index was outside the bounds of the array.
*/

Комментарии

Метод DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) создает объект , MethodCallExpression представляющий вызов DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) , зависит от реализации типа source параметра. Ожидаемое поведение заключается в том, что он возвращает значение source , если он не пуст. В противном случае он возвращает объект IQueryable<T> , содержащий defaultValue.

DefaultIfEmpty<TSource>(IQueryable<TSource>)

Исходный код:

Queryable.cs

Возвращает элементы указанной последовательности или одноэлементную коллекцию, содержащую значение параметра типа по умолчанию, если последовательность пуста.

C#

public static System.Linq.IQueryable<TSource?> DefaultIfEmpty<TSource> (this System.Linq.IQueryable<TSource> source);

Параметры типа

TSource

Тип элементов source.

Параметры

source

IQueryable<TSource>

Объект IQueryable<T>, для которого возвращается значение по умолчанию, если последовательность пуста.

Возвращаемое значение

IQueryable<TSource>

Объект IQueryable<T>, содержащий значение default(TSource), если последовательность source пуста; в противном случае возвращается source.

Исключения

ArgumentNullException

source имеет значение null.

Примеры

В следующих примерах кода показано, как использовать DefaultIfEmpty<TSource>(IQueryable<TSource>) для предоставления значения по умолчанию в случае, если исходная последовательность пуста.

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void DefaultIfEmptyEx1()
{
    // Create a list of Pet objects.
    List<Pet> pets =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 } };

    // Call DefaultIfEmtpy() on the collection that Select()
    // returns, so that if the initial list is empty, there
    // will always be at least one item in the returned array.
    string[] names =
        pets.AsQueryable()
        .Select(pet => pet.Name)
        .DefaultIfEmpty()
        .ToArray();

    string first = names[0];
    Console.WriteLine(first);
}

/*
    This code produces the following output:

    Barley
*/

Комментарии

Метод DefaultIfEmpty<TSource>(IQueryable<TSource>) создает объект , MethodCallExpression представляющий вызов DefaultIfEmpty<TSource>(IQueryable<TSource>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов DefaultIfEmpty<TSource>(IQueryable<TSource>) , зависит от реализации типа source параметра. Ожидаемое поведение заключается в том, что он возвращает значение source , если он не пуст. В противном случае он возвращает объект IQueryable<T> , содержащий default(TSource).