ObjectQuery<T>.Skip(String, String, ObjectParameter[]) Método

Definição

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Ordena os resultados da consulta pelos critérios especificados e ignora um número especificado de resultados.

public:
 System::Data::Objects::ObjectQuery<T> ^ Skip(System::String ^ keys, System::String ^ count, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public System.Data.Objects.ObjectQuery<T> Skip (string keys, string count, params System.Data.Objects.ObjectParameter[] parameters);

member this.Skip : string * string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectQuery<'T>

Public Function Skip (keys As String, count As String, ParamArray parameters As ObjectParameter()) As ObjectQuery(Of T)

Parâmetros

keys

String

As colunas de chave pelas quais os resultados serão ordenados.

count

String

O número de resultados a ignorar. Deve ser uma constante ou uma referência de parâmetro.

parameters

ObjectParameter[]

Um conjunto opcional de parâmetros de consulta que devem estar no escopo durante a análise.

Retornos

ObjectQuery<T>

Uma nova instância de ObjectQuery<T> que é equivalente à instância original com ORDER BY e SKIP aplicados.

Exceções

ArgumentNullException

Qualquer argumento é null.

ArgumentException

keys é uma cadeia de caracteres vazia.

- ou -

count é uma cadeia de caracteres vazia.

Exemplos

Este exemplo obtém cinco Product objetos depois de ignorar os três primeiros no resultado da consulta, classificados por Product.ListPrice.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    // Define the parameters used to define the "page" of returned data.
    int skipValue = 3;
    int limitValue = 5;

    // Define a query that returns a "page" or the full
    // Product data using the Skip and Top methods.
    // When Top() follows Skip(), it acts like the LIMIT statement.
    ObjectQuery<Product> query = context.Products
        .Skip("it.ListPrice", "@skip",
                new ObjectParameter("skip", skipValue))
        .Top("@limit", new ObjectParameter("limit", limitValue));

    // Iterate through the page of Product items.
    foreach (Product result in query)
        Console.WriteLine("ID: {0}; Name: {1}",
        result.ProductID, result.Name);
}

Comentários

O Skip método não pode ser usado após o Top método . Quando você usa Top após Skip, ele funciona como a instrução LIMIT de uma ORDER BY cláusula .

Confira também

• Consultando dados como objetos (Entity Framework)