ObjectQuery<T>.Top(String, ObjectParameter[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Nouvelle instance ObjectQuery<T> qui est équivalente à l'instance d'origine avec TOP appliqué.
Exceptions
count
a la valeur null
.
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 .