Enumerable.DefaultIfEmpty Metodo

Definizione

Spazio dei nomi:

System.Linq

Assembly:

System.Linq.dll

Restituisce gli elementi di un IEnumerable<T>oppure un insieme singleton con valori predefinito se la sequenza è vuota.

Overload

DefaultIfEmpty<TSource>(IEnumerable<TSource>)	Restituisce gli elementi della sequenza specificata o il valore predefinito del parametro di tipo in un insieme singleton se la sequenza è vuota.
DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)	Restituisce gli elementi della sequenza specificata o il valore specificato in una raccolta singleton se la sequenza è vuota.

DefaultIfEmpty<TSource>(IEnumerable<TSource>)

Origine:

DefaultIfEmpty.cs

Restituisce gli elementi della sequenza specificata o il valore predefinito del parametro di tipo in un insieme singleton se la sequenza è vuota.

C#

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

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source

IEnumerable<TSource>

Sequenza per cui restituire un valore predefinito se è vuoto.

Restituisce

IEnumerable<TSource>

Oggetto IEnumerable<T> che contiene il valore predefinito per il tipo di TSource se source è vuoto; in caso contrario, source.

Eccezioni

ArgumentNullException

source è null.

Esempio

Gli esempi di codice seguenti illustrano come usare DefaultIfEmpty<TSource>(IEnumerable<TSource>) per fornire un valore predefinito nel caso in cui la sequenza di origine sia vuota.

In questo esempio viene utilizzata una sequenza non vuota.

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
*/

In questo esempio viene utilizzata una sequenza vuota.

C#

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

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

/*
 This code produces the following output:

 0
*/

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando direttamente il relativo metodo GetEnumerator o usando foreach in C# o For Each in Visual Basic.

Il valore predefinito per i tipi reference e nullable è null.

Questo metodo può essere usato per produrre un left outer join quando viene combinato con il metodo GroupJoin.

Vedi anche

• operazioni di join (C#)
• operazioni di join (Visual Basic)

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

Origine:

DefaultIfEmpty.cs

Restituisce gli elementi della sequenza specificata o il valore specificato in una raccolta singleton se la sequenza è vuota.

C#

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

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source

IEnumerable<TSource>

Sequenza per cui restituire il valore specificato per se è vuoto.

defaultValue

TSource

Valore da restituire se la sequenza è vuota.

Restituisce

IEnumerable<TSource>

Un IEnumerable<T> che contiene defaultValue se source è vuoto; in caso contrario, source.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il metodo DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) e specificare un valore predefinito. La prima sequenza non è vuota e la seconda sequenza è vuota.

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
*/

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando direttamente il relativo metodo GetEnumerator o usando foreach in C# o For Each in Visual Basic.

Questo metodo può essere usato per produrre un left outer join quando viene combinato con il metodo GroupJoin.

Vedi anche

• operazioni di join (C#)
• operazioni di join (Visual Basic)