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

Definição

Espaço de Nomes:
System.Data.Objects
Assemblagem:
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-chave pelas quais ordenar os resultados.

count
String

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

parameters
ObjectParameter[]

Um conjunto opcional de parâmetros de consulta que deve estar dentro do âmbito ao analisar.

Devoluções

ObjectQuery<T>

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

Exceções

ArgumentNullException

Qualquer argumento é null.

ArgumentException

keys é uma corda vazia.

-ou-

count é uma corda vazia.

Exemplos

Este exemplo obtém cinco Product objetos depois de saltar os três primeiros no resultado da consulta, ordenados 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);
}

Observações

O Skip método não pode ser usado depois do Top método. Quando usas Top depois Skipde , funciona como a instrução LIMIT de uma ORDER BY cláusula.

Aplica-se a

Ver também