Método Enumerable.DefaultIfEmpty<TSource> (IEnumerable<TSource>)

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

Observação de uso

Esse método é implementado usando execução retardada. A imediata retorna o valor é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto é enumerado ou chamando seu GetEnumerator método diretamente ou por meio de foreach na Visual C# ou For Each na Visual Basic.

O valor padrão para referência e tipos anuláveis é null.

Esse método pode ser usado para produzir uma junção externa esquerda quando ele for combinado com o GroupJoin) método.

Os exemplos de código a seguir demonstram como usar DefaultIfEmpty<TSource>(IEnumerable<TSource>) para fornecer um valor padrão caso a seqüência de origem está vazia.

Este exemplo usa uma seqüência não vazia.

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

Este exemplo usa uma seqüência vazia.

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

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

            /*
             This code produces the following output:

             0
            */

.NET Framework

.NET Framework Client Profile

Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Referência

Outros recursos