Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Enumerable.DefaultIfEmpty<TSource>(IEnumerable<TSource>)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IEnumerable<TSource> DefaultIfEmpty<TSource>(
	this IEnumerable<TSource> source
)

Parametri

source
Type: System.Collections.Generic.IEnumerable<TSource>

Sequenza per cui restituire un valore predefinito se è vuota.

Valore restituito

Type: System.Collections.Generic.IEnumerable<TSource>

Un IEnumerable<T> oggetto che contiene il valore predefinito per il TSource digitare se source è vuota; in caso contrario, source.

Parametri tipo

TSource

Tipo degli elementi di source.

Exception Condition
ArgumentNullException

source è null.

Questo metodo viene implementato tramite 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 viene enumerata chiamando il relativo GetEnumerator metodo direttamente o tramite foreach in Visual C# o For Each in Visual Basic.

Il valore predefinito per riferimento e tipi nullable è null.

Questo metodo può essere utilizzato per produrre un left outer join quando è combinato con il GroupJoin<TOuter, TInner, TKey, TResult>) metodo.

Gli esempi di codice seguente viene illustrato come utilizzare DefaultIfEmpty<TSource>(IEnumerable<TSource>) per fornire un valore predefinito nel caso in cui la sequenza di origine è vuota.

In questo esempio viene utilizzata una sequenza non vuota.

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

Nell'esempio viene utilizzata una sequenza vuota.

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

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

/*
 This code produces the following output:

 0
*/

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 3.5
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: