Freigeben über


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

Definition

Ordnet die Abfrageergebnisse nach den angegebenen Kriterien und überspringt eine bestimmte Anzahl von Ergebnissen.

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.

count
String

Die Anzahl zu überspringender Ergebnisse. Dabei muss es sich um eine Konstante oder einen Parameterverweis handeln.

parameters
ObjectParameter[]

Ein optionaler Satz von Abfrageparametern, die sich beim Analysieren im Gültigkeitsbereich befinden sollten.

Gibt zurück

Eine neue ObjectQuery<T>-Instanz, die der ursprünglichen Instanz entspricht, für die jedoch ORDER BY und SKIP festgelegt ist.

Ausnahmen

Jedes Argument ist null.

keys ist eine leere Zeichenfolge.

- oder -

count ist eine leere Zeichenfolge.

Beispiele

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

Hinweise

Die Skip-Methode kann nicht nach der Top-Methode verwendet werden. Wenn Sie nach SkipverwendenTop, funktioniert sie wie die LIMIT-Anweisung einer ORDER BY Klausel.

Gilt für:

Weitere Informationen