Como: retornar a uma consulta de um método (guia de programação do C#)
Este exemplo mostra como retornar a uma consulta de um método como o valor de retorno e um out parâmetro.
Qualquer consulta deve ter um tipo de IEnumerable ou IEnumerable<T>, ou um tipo derivado, como IQueryable<T>.Portanto, qualquer valor de retorno ou out o parâmetro de um método que retorna uma consulta também deve ter esse tipo.Se um método materializes uma consulta em um concreto List<T> ou Array tipo, ele é considerado estar retornando os resultados da consulta em vez da própria consulta.Uma variável de consulta que é retornada de um método ainda pode ser composta ou modificada.
Exemplo
No exemplo a seguir, o primeiro método retorna uma consulta como um valor de retorno e o segundo método retorna uma consulta como um out parâmetro.Observe que em ambos os casos é uma consulta que é retornado, não os resultados da consulta.
class MQ
{
// QueryMethhod1 returns a query as its value.
IEnumerable<string> QueryMethod1(ref int[] ints)
{
var intsToStrings = from i in ints
where i > 4
select i.ToString();
return intsToStrings;
}
// QueryMethod2 returns a query as the value of parameter returnQ.
void QueryMethod2(ref int[] ints, out IEnumerable<string> returnQ)
{
var intsToStrings = from i in ints
where i < 4
select i.ToString();
returnQ = intsToStrings;
}
static void Main()
{
MQ app = new MQ();
int[] nums = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
// QueryMethod1 returns a query as the value of the method.
var myQuery1 = app.QueryMethod1(ref nums);
// Query myQuery1 is executed in the following foreach loop.
Console.WriteLine("Results of executing myQuery1:");
// Rest the mouse pointer over myQuery1 to see its type.
foreach (string s in myQuery1)
{
Console.WriteLine(s);
}
// You also can execute the query returned from QueryMethod1
// directly, without using myQuery1.
Console.WriteLine("\nResults of executing myQuery1 directly:");
// Rest the mouse pointer over the call to QueryMethod1 to see its
// return type.
foreach (string s in app.QueryMethod1(ref nums))
{
Console.WriteLine(s);
}
IEnumerable<string> myQuery2;
// QueryMethod2 returns a query as the value of its out parameter.
app.QueryMethod2(ref nums, out myQuery2);
// Execute the returned query.
Console.WriteLine("\nResults of executing myQuery2:");
foreach (string s in myQuery2)
{
Console.WriteLine(s);
}
// You can modify a query by using query composition. A saved query
// is nested inside a new query definition that revises the results
// of the first query.
myQuery1 = from item in myQuery1
orderby item descending
select item;
// Execute the modified query.
Console.WriteLine("\nResults of executing modified myQuery1:");
foreach (string s in myQuery1)
{
Console.WriteLine(s);
}
// Keep console window open in debug mode.
Console.WriteLine("Press any key to exit.");
Console.ReadKey();
}
}
Compilando o código
Criar um Visual Studio o projeto que se destina a.NET Framework versão 3.5 ou posterior.Por padrão, o projeto tem uma referência a System.Core.dll e um using diretriz para o namespace System. LINQ.
Substitua a classe com o código do exemplo.
Pressione F5 para compilar e executar o programa.
Pressione qualquer tecla para sair da janela do console.