Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Metodo Queryable.DefaultIfEmpty<TSource> (IQueryable<TSource>, TSource)

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

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in System.Core.dll)
public static IQueryable<TSource> DefaultIfEmpty<TSource>(
	this IQueryable<TSource> source,
	TSource defaultValue
)

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Linq.IQueryable<TSource>
Oggetto IQueryable<T> per il quale restituire il valore specificato se vuoto.
defaultValue
Tipo: TSource
Valore da restituire se la sequenza è vuota.

Valore restituito

Tipo: System.Linq.IQueryable<TSource>
Oggetto IQueryable<T> che contiene defaultValue se source è vuota; in caso contrario, source.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IQueryable<TSource>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) oppure Metodi di estensione (Guida per programmatori C#).
EccezioneCondizione
ArgumentNullException

source è null.

Il metodo DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) genera un oggetto MethodCallExpression che rappresenta una chiamata al metodo DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) stesso come un metodo generico costruito. Passa quindi un oggetto MethodCallExpression al metodo CreateQuery<TElement>(Expression) di IQueryProvider rappresentato dalla proprietà Provider del parametro source.

Il comportamento della query conseguente all'esecuzione di una struttura ad albero dell'espressione che rappresenta una chiamata a DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) dipende dall'implementazione del tipo del parametro source. In base al comportamento previsto, viene restituito l’oggetto source se questo non è vuoto. In caso contrario, restituisce un oggetto IQueryable<T> che contiene defaultValue.

Nell'esempio di codice riportato di seguito viene illustrata una situazione nella quale è utile chiamare DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) in una query LINQ. In questo esempio viene passato a DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) un valore predefinito.


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



.NET Framework

Supportato in: 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft. Tutti i diritti riservati.