ObjectQuery<T>.Skip(String, String, ObjectParameter[]) Метод

Определение

Упорядочивает результаты запроса по заданному критерию и пропускает указанное число результатов.Orders the query results by the specified criteria and skips a specified number of results.

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)

Параметры

keys
String

Ключевые столбцы, по которым упорядочиваются результаты.The key columns by which to order the results.

count
String

Число результатов, которые нужно пропустить.The number of results to skip. Может быть константой или ссылкой на параметр.This must be either a constant or a parameter reference.

parameters
ObjectParameter[]

Дополнительный набор параметров запроса, которые должны находиться в области действия во время синтаксического анализа.An optional set of query parameters that should be in scope when parsing.

Возвращаемое значение

ObjectQuery<T>

Новый экземпляр запроса ObjectQuery<T>, эквивалентный первоначальному экземпляру с примененными к нему предложениями ORDER BY и SKIP.A new ObjectQuery<T> instance that is equivalent to the original instance with both ORDER BY and SKIP applied.

Исключения

Любой аргумент равен null.Any argument is null.

Параметр keys равен пустой строке.keys is an empty string.

-или--or-

Параметр count равен пустой строке.count is an empty string.

Примеры

Этот пример получает пять Product объектов после пропуска первых трех результатов запроса, отсортированных по Product.ListPrice .This example gets five Product objects after skipping the first three in the query result, sorted by 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);
}
Using context As New AdventureWorksEntities()
    ' Define the parameters used to define the "page" of returned data. 
    Dim skipValue As Integer = 3
    Dim limitValue As Integer = 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. 
    Dim query As ObjectQuery(Of Product) = _
        context.Products.Skip("it.ListPrice", "@skip", _
            New ObjectParameter("skip", skipValue)).Top("@limit", New ObjectParameter("limit", limitValue))

    ' Iterate through the page of Product items. 
    For Each result As Product In query
        Console.WriteLine("ID: {0}; Name: {1}", result.ProductID, result.Name)
    Next
End Using

Комментарии

Метод Skip не может использоваться после метода Top.The Skip method cannot be used after the Top method. Когда вы используете Top After Skip , он работает так же, как оператор Limit предложения.When you use Top after Skip, it functions like the LIMIT statement of an clause.

Применяется к