Uma query é um conjunto de instruções que descrevem qual dado receber de um data source(ou sources) e em qual formato e organização os dados deveriam ter. Uma query é diferenciada a partir dos resultados que ela produz.

Geralmente, os dados de origem são organizados logicamente como uma sequência de elementos do mesmo tipo. Uma tabela de um banco de dados SQL contém uma sequência de linhas. Similarly, an ADO.NET DataTable contains a sequence of DataRow objects. Em um arquivo XML, existe uma "sequência" de elementos XML (apesar destes serem organizados hierarquicamente em uma estrutura de árvore). Uma coleçao na mémoria contém uma sequência de objetos.

Do ponto de vista do aplicativo, o tipo específico e a estrutura dos dados de origem original não é importante. O aplicativo sempre vê os dados de origem como um IEnumerable<(Of <(T>)>) ou IQueryable<(Of <(T>)>) coleção. Em LINQ to XML, os dados de origem são tornados Visível como um IEnumerable<XElement >. Em LINQ to DataSet, é um IEnumerable<DataRow >. Em LINQ to SQL, é um IEnumerable ou IQueryable de qualquer Personalizar objetos que você definiu para representar os dados na tabela SQL.

Dada essa seqüência de origem, uma consulta pode siga um destes três coisas:

• Recupere um subconjunto dos elementos para produzir uma Novo seqüência sem modificar os elementos individuais. A consulta pode em seguida, classificar ou agrupar a seqüência retornada em várias formas, conforme o exemplo seguinte (presuma scores é uma int[]):

  C#

  IEnumerable<int> highScoresQuery =
      from score in scores
      where score > 80
      orderby score descending
      select score;
  

• Recuperar uma seqüência de elementos como no exemplo anterior, mas Transformará-los para um novo tipo de objeto. Por exemplo, uma consulta pode recuperar apenas os últimos nomes de determinados registros de cliente em uma Origem de dados. Ou ele pode recuperar o registro completo e usá-lo para criar outro tipo de objeto de memória ou até mesmo dados XML antes de gerar a seqüência do resultado final. O exemplo a seguir mostra uma Transformarar de um int para um string. Anotação o novo tipo de highScoresQuery.

  C#

  IEnumerable<string> highScoresQuery2 =
      from score in scores
      where score > 80
      orderby score descending
      select String.Format("The score is {0}", score);
  

• Recuperar um valor singleton sobre os dados de origem, tais como:

  • O número de elementos que coincidam com uma determinada condição.

  • O elemento que possui o valor maior ou menor.

  • O primeiro elemento que corresponde a uma condição ou soma de valores específicos de um conjunto especificado de elementos. Por exemplo, a seguinte consulta retorna o número de pontuação maior do que 80 da matriz de inteiro scores:

  C#

  int highScoreCount =
      (from score in scores
       where score > 80
       select score)
       .Count();
  

  No exemplo anterior, Anotação o uso de parênteses em torno da expressão de consulta antes da chamada ao método Count. Você também pode expressar isso usando uma Novo variável para armazenar o resultado de concreto. Essa técnica é mais legível, pois ele mantém a variável que armazede a consulta separade da consulta que armazede um resultade.

  C#

  IEnumerable<int> highScoresQuery3 =
      from score in scores
      where score > 80
      select score;
  
  int scoreCount = highScoresQuery3.Count();
  

No exemplo anterior, a consulta é executada na chamada para Count, porque Count deve iterar sobre os resultados em Ordem para determinar o número de elementos retornados pela highScoresQuery.

Um de expressão de consulta é uma consulta expressa na sintaxe de consulta. Uma expressão de consulta é uma Primeiro classe Idioma construir. Ele é como qualquer outra expressão e pode ser usado em qualquer contexto em que uma expressão de C# é válida. Uma expressão de consulta consiste em um conjunto das cláusulas escrito em uma sintaxe declarativa semelhante a SQL ou XQuery. Cada cláusula por sua vez contém um ou mais expressões do C# e essas expressões podem se ser uma expressão de consulta ou conter uma expressão de consulta.

Uma expressão de consulta deve começar com um cláusula from e deve terminar com umSelecionar de ou AAgruparar cláusula. Entre a Primeiro cláusula from e o último select ou group cláusula, ele pode conter um ou mais dessas cláusulas opcionais: onde, orderby, Junção, permitem e até adicionais de cláusulas. Também pode usar o na palavra-chave para habilitar o resultado de um join ou group cláusula para servir como a Origem para as cláusulas de consulta adicional na mesma expressão de consulta.

A variável de consulta

Em LINQ, uma variável de consulta é qualquer variável que armazena um de consulta em vez do de uma consulta de resultados. Mais especificamente, uma variável de consulta sempre é um tipo enumeráveis que produzirá uma seqüência de elementos quando ele é iterado em uminstrução de foreach ou uma chamada direta para o método IEnumerator.MoveNext.

O exemplo de código a seguir mostra uma expressão de consulta simples com uma fonte de dados, uma cláusula de filtragem, uma cláusula de pedido e nenhuma transformação dos elementos de origem. A cláusula select termina a consulta.

C#

static void Main()
{
    // Data source.
    int[] scores = { 90, 71, 82, 93, 75, 82 };

    // Query Expression.
    IEnumerable<int> scoreQuery = //query variable
        from score in scores //required
        where score > 80 // optional
        orderby score descending // optional
        select score; //must end with select or group

    // Execute the query to produce the results
    foreach (int testScore in scoreQuery)
    {
        Console.WriteLine(testScore);
    }                  
}
// Outputs: 90 82 93 82      

No exemplo anterior, scoreQuery é uma variável de consulta de ,que às vezes é chamado de apenas umconsulta. A variável de consulta armazena não dados resultado real, que são produzidos no loop foreach. E quando executa a instrução de foreach , os resultados da consulta não são retornados Através a variável de consulta scoreQuery. Em vez disso, eles são retornados Através a variável de iteração testScore. A variável scoreQuery pode ser iterada em um segundo loop foreach. Ela produzirá os mesmos resultados, desde que ele nem a Origem de dados foi modificada.

Uma variável de consulta pode armazenar uma consulta que é expresso na sintaxe de consulta ou sintaxe do método ou uma combinação dos dois. Os exemplos a seguir, os queryMajorCities e o queryMajorCities2 são variáveis de consulta:

C#

//Query syntax
IEnumerable<City> queryMajorCities =
    from city in cities
    where city.Population > 100000
    select city;


// Method-based syntax
IEnumerable<City> queryMajorCities2 = cities.Where(c => c.Population > 100000);

Através outro lado, os exemplos de dois a seguir mostram variáveis que não são variáveis de consulta, mesmo em cada é iniciada com uma consulta. Eles não são variáveis de consulta porque armazenam os resultados:

C#

int highestScore =
    (from score in scores
     select score)
    .Max();

// or split the expression
IEnumerable<int> scoreQuery =
    from score in scores
    select score;

int highScore = scoreQuery.Max();

IEnumerable<City> largeCityList =
    (from country in countries
     from city in country.Cities
        where city.Population > 10000
        select city)
       .ToList();

// or split the expression
IEnumerable<City> largeCityList2 =
    from country in countries
     from city in country.Cities
     where city.Population > 10000
     select city;

List<City> largeCities = largeCityList2.ToList();

Observação:
Na Documentação de LINQ, variáveis que armazenam uma consulta têm a palavra "consulta" como parte de seus nomes. Variáveis que armazenam um resultado real não é necessário "consulta" em seus nomes.

Para obter mais informações sobre as diferentes maneiras para expressar consultas, consulte Sintaxe de consulta versus sintaxe do método (LINQ).

Explícito e implícita de digitação de variáveis de consulta

Esta documentação geralmente fornece o tipo explícito da variável de consulta em Ordem para mostrar o tipo de relação entre a variável de consulta e o Selecionar cláusula. No entanto, também pode usar a palavra-chave var para instruir o compilador a inferir o tipo de uma variável de consulta (ou qualquer outra variável local) em tempo de compilação. Por exemplo, o exemplo de consulta que foi mostrado anteriormente neste tópico também pode ser expresso por meio de digitação implícita:

C#

// Use of var is optional here and in all queries.
// queryCities is an IEnumerable<City> just as 
// when it is explicitly typed.
var queryCities =
    from city in cities
    where city.Population > 100000
    select city;

Para obter mais informações, consulte Digitada implicitamente variáveis Local (C# Guia de programação) e Relações de tipo em operações de Consulta (LINQ).

Iniciar uma expressão de consulta

IEnumerable<Country> countryAreaQuery =
    from country in countries
    where country.Area > 500000 //sq km
    select country;

IEnumerable<City> cityQuery =
    from country in countries
    from city in country.Cities
    where city.Population > 10000
    select city;

Encerrar uma expressão de consulta

var queryCountryGroups =
    from country in countries
    group country by country.Name[0];

IEnumerable<Country> sortedQuery =
    from country in countries
    orderby country.Area
    select country;

// Here var is required because the query
// produces an anonymous type.
var queryNameAndPop =
    from country in countries
    select new { Name = country.Name, Pop = country.Population };

// percentileQuery is an IEnumerable<IGrouping<int, Country>>
var percentileQuery =
    from country in countries
    let percentile = (int) country.Population / 10000000
    group country by percentile into countryGroup
    where countryGroup.Key >= 20
    orderby countryGroup.Key
    select countryGroup;

// grouping is an IGrouping<int, Country>
foreach (var grouping in percentileQuery)
{
    Console.WriteLine(grouping.Key);
    foreach (var country in grouping)
        Console.WriteLine(country.Name + ":" + country.Population);
}

Filtragem, classificação e ingressando em

IEnumerable<City> queryCityPop =
    from city in cities
    where city.Population < 200000 && city.Population > 100000
    select city;

IEnumerable<Country> querySortedCountries =
    from country in countries
    orderby country.Area > 500000, country.Population descending
    select country;

var categoryQuery =
    from cat in categories
    join prod in products on cat equals prod.Category
    select new { Category = cat, Name = prod.Name };

string[] names = { "Svetlana Omelchenko", "Claire O'Donnell", "Sven Mortensen", "Cesar Garcia" };
IEnumerable<string> queryFirstNames =
    from name in names
    let firstName = name.Split(new char[] { ' ' })[0]
    select firstName;

foreach (string s in queryFirstNames)
    Console.Write(s + " ");
//Output: Svetlana Claire Sven Cesar

Subconsultas em uma expressão de consulta

var queryGroupMax =
    from student in students
    group student by student.GradeLevel into studentGroup
    select new
    {
        Level = studentGroup.Key,
        HighestScore =
            (from student2 in studentGroup
             select student2.Scores.Average())
             .Max()
    };

Conceitos

Referência

Outros recursos