yield
yield retorna um objeto que implementa a interface IEnumerable, ou seja um iterator.
Segue um exemplo, onde yield return
é utilizada para retornar uma lista de mensagem de validação:
using System.IO;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
Entidade novaEntidade = new Entidade();
var mensagens = novaEntidade.ObterMensagensValidacao();
foreach(var msg in mensagens)
{
Console.WriteLine(msg);
}
}
}
public class Entidade
{
public string Nome { get; set; }
public string Telefone { get; set; }
public IEnumerable<string> ObterMensagensValidacao()
{
if(String.IsNullOrWhiteSpace(this.Nome))
{
yield return "O nome deve ser preenchido.";
}
if(String.IsNullOrWhiteSpace(this.Telefone))
{
yield return "O telefone deve ser preenchido.";
}
}
}
Já yield break
você pode utilizar para sair de uma iteração.
yield break
especifica que um iterador chegou ao fim.
Exemplo:
public IEnumerable<int> ObterNumeros()
{
int i = 0;
while (true) {
if (i < 5) {
yield return i;
} else {
yield break;
}
i++;
}
}
Ao iterar sobre o retorno do método acima serão impressos os números de 0 a 4 conforme yield break
utilizado.
var numeros = novaEntidade.ObterNumeros();
foreach(var num in numeros)
{
Console.Write(num);
//Serão impressos: 0 1 2 3 4
}