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

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Limite les résultats de la requête à un nombre d'éléments spécifié.

public:
 System::Data::Objects::ObjectQuery<T> ^ Top(System::String ^ count, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public System.Data.Objects.ObjectQuery<T> Top (string count, params System.Data.Objects.ObjectParameter[] parameters);

member this.Top : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectQuery<'T>

Public Function Top (count As String, ParamArray parameters As ObjectParameter()) As ObjectQuery(Of T)

Paramètres

count

String

Nombre d'éléments du résultat sous la forme d'une chaîne.

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 TOP appliqué.

Exceptions

ArgumentNullException

count a la valeur null.

ArgumentException

count est une chaîne vide.

Exemples

Cet exemple crée un nouvel objet ObjectQuery<T> qui contient les deux premiers résultats de la requête existante.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE product FROM AdventureWorksEntities.Products AS product";

    ObjectQuery<Product> productQuery1 =
        new ObjectQuery<Product>(queryString, context, MergeOption.NoTracking);

    ObjectQuery<Product> productQuery2 = productQuery1.Top("2");

    // Iterate through the collection of Product items.
    foreach (Product result in productQuery2)
        Console.WriteLine("{0}", result.Name);
}

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. Top est utilisé au lieu de LIMIT pour la pagination.

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

Top est non déterministe, à moins que la requête soit triée.

Lorsque vous utilisez la Top méthode après la Skip méthode, elle fonctionne comme l’instruction LIMIT d’une clause ORDER BY .

Voir aussi

• Interrogation des données sous forme d'objets (Entity Framework)