Compartilhar via


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

Definição

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

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

Exceções

Qualquer argumento é null.

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 .

Aplica-se a

Confira também