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

  • Référence

Définition

Espace de noms:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Classe les résultats de la requête selon les critères spécifiés et ignore un nombre spécifié de résultats.

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)

Paramètres

keys
String

Colonnes clés par lesquelles ordonner les résultats.

count
String

Nombre de résultats à ignorer. Ce nombre doit être une constante ou une référence de paramètre.

parameters
ObjectParameter[]

Jeu facultatif de paramètres de requête qui doivent être dans l'étendue lors de l'analyse.

Retours

ObjectQuery<T>

Nouvelle instance ObjectQuery<T> qui est équivalente à l'instance d'origine avec ORDER BY et SKIP appliqués.

Exceptions

ArgumentNullException

Tous les arguments ont la valeur null.

ArgumentException

keys est une chaîne vide.

- ou -

count est une chaîne vide.

Exemples

Cet exemple obtient cinq Product objets après avoir ignoré les trois premiers du résultat de la requête, triés par 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);
}

Remarques

La méthode Skip ne peut pas être utilisée après la méthode Top. Lorsque vous utilisez Top après Skip, elle fonctionne comme l’instruction LIMIT d’une ORDER BY clause.

S’applique à

Voir aussi