ObjectQuery<T>.Skip(String, String, ObjectParameter[]) Methode

Definition

Ordnet die Abfrageergebnisse nach den angegebenen Kriterien und überspringt eine bestimmte Anzahl von Ergebnissen.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)

Parameter

keys
String

Die Schlüsselspalten, nach denen die Ergebnisse geordnet werden.The key columns by which to order the results.

count
String

Die Anzahl zu überspringender Ergebnisse.The number of results to skip. Dabei muss es sich um eine Konstante oder einen Parameterverweis handeln.This must be either a constant or a parameter reference.

parameters
ObjectParameter[]

Ein optionaler Satz von Abfrageparametern, die sich beim Analysieren im Gültigkeitsbereich befinden sollten.An optional set of query parameters that should be in scope when parsing.

Gibt zurück

Eine neue ObjectQuery<T>-Instanz, die der ursprünglichen Instanz entspricht, für die jedoch ORDER BY und SKIP festgelegt sind.A new ObjectQuery<T> instance that is equivalent to the original instance with both ORDER BY and SKIP applied.

Ausnahmen

Jedes Argument ist null.Any argument is null.

keys ist eine leere Zeichenfolge.keys is an empty string.

- oder --or-

count ist eine leere Zeichenfolge.count is an empty string.

Beispiele

In diesem Beispiel werden fünf Product Objekte abgerufen, nachdem die ersten drei Objekte im Abfrageergebnis übersprungen wurden, sortiert nach 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

Hinweise

Die Skip-Methode kann nicht nach der Top-Methode verwendet werden.The Skip method cannot be used after the Top method. Wenn Sie Top nach Skipverwenden, funktioniert es wie die Limit -Anweisung einer-Klausel.When you use Top after Skip, it functions like the LIMIT statement of an clause.

Gilt für:

Siehe auch