Enumerable.DefaultIfEmpty 方法

定義

命名空間:

System.Linq

組件:

System.Linq.dll

傳回 IEnumerable<T>的專案，如果序列是空的，則傳回預設值單一集合。

多載

DefaultIfEmpty<TSource>(IEnumerable<TSource>)	如果序列是空的，則傳回指定序列的專案或單一集合中型別參數的預設值。
DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)	如果序列是空的，則傳回指定序列的專案或單一集合中的指定值。

DefaultIfEmpty<TSource>(IEnumerable<TSource>)

來源:

DefaultIfEmpty.cs

如果序列是空的，則傳回指定序列的專案或單一集合中型別參數的預設值。

C#

public static System.Collections.Generic.IEnumerable<TSource?> DefaultIfEmpty<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

類型參數

TSource

source專案的型別。

參數

source

IEnumerable<TSource>

如果預設值是空的，則傳回的序列。

傳回

IEnumerable<TSource>

IEnumerable<T> 物件，如果 source 是空的，則包含 TSource 型別的預設值;否則，source。

例外狀況

ArgumentNullException

source null。

範例

下列程式代碼範例示範如何使用 DefaultIfEmpty<TSource>(IEnumerable<TSource>) 提供預設值，以防來源序列是空的。

此範例使用非空白序列。

C#

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

public static void DefaultIfEmptyEx1()
{
    List<Pet> pets =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 } };

    foreach (Pet pet in pets.DefaultIfEmpty())
    {
        Console.WriteLine(pet.Name);
    }
}

/*
 This code produces the following output:

 Barley
 Boots
 Whiskers
*/

此範例會使用空序列。

C#

List<int> numbers = new List<int>();

foreach (int number in numbers.DefaultIfEmpty())
{
    Console.WriteLine(number);
}

/*
 This code produces the following output:

 0
*/

備註

這個方法是使用延後執行來實作。 立即傳回值是物件，可儲存執行動作所需的所有資訊。 除非直接呼叫物件 GetEnumerator 方法或在 C# 中使用 foreach，或在 Visual Basic 中使用 For Each，否則不會執行這個方法所代表的查詢。

參考與 Null 型別預設值為 null。

當此方法與 GroupJoin 方法結合時，可以用來產生左外部聯結。

另請參閱

• 聯結作業 （C#）
• 聯結作業 （Visual Basic）

DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)

來源:

DefaultIfEmpty.cs

如果序列是空的，則傳回指定序列的專案或單一集合中的指定值。

C#

public static System.Collections.Generic.IEnumerable<TSource> DefaultIfEmpty<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource defaultValue);

類型參數

TSource

source專案的型別。

參數

source

IEnumerable<TSource>

如果指定值是空的，則傳回的序列。

defaultValue

TSource

如果序列是空的，則傳回的值。

傳回

IEnumerable<TSource>

如果 source 是空的，則為包含 defaultValue 的 IEnumerable<T>;否則，source。

範例

下列程式代碼範例示範如何使用 DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) 方法並指定預設值。 第一個序列不是空的，而第二個序列是空的。

C#

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

public static void DefaultIfEmptyEx2()
{
    Pet defaultPet = new Pet { Name = "Default Pet", Age = 0 };

    List<Pet> pets1 =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 } };

    foreach (Pet pet in pets1.DefaultIfEmpty(defaultPet))
    {
        Console.WriteLine("Name: {0}", pet.Name);
    }

    List<Pet> pets2 = new List<Pet>();

    foreach (Pet pet in pets2.DefaultIfEmpty(defaultPet))
    {
        Console.WriteLine("\nName: {0}", pet.Name);
    }
}

/*
 This code produces the following output:

 Name: Barley
 Name: Boots
 Name: Whiskers

 Name: Default Pet
*/

備註

這個方法是使用延後執行來實作。 立即傳回值是物件，可儲存執行動作所需的所有資訊。 除非直接呼叫物件 GetEnumerator 方法或在 C# 中使用 foreach，或在 Visual Basic 中使用 For Each，否則不會執行這個方法所代表的查詢。

當此方法與 GroupJoin 方法結合時，可以用來產生左外部聯結。

另請參閱

• 聯結作業 （C#）
• 聯結作業 （Visual Basic）