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

Definitie

Naamruimte:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Hiermee beperkt u de queryresultaten tot een opgegeven aantal items.

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)

Parameters

count
String

Het aantal items in de resultaten als een tekenreeks.

parameters
ObjectParameter[]

Een optionele set queryparameters die binnen het bereik moeten vallen bij het parseren.

Retouren

ObjectQuery<T>

Een nieuw ObjectQuery<T> exemplaar dat gelijk is aan het oorspronkelijke exemplaar waarop TOP is toegepast.

Uitzonderingen

ArgumentNullException

count is null.

ArgumentException

count is een lege tekenreeks.

Voorbeelden

In dit voorbeeld wordt een nieuwe ObjectQuery<T> gemaakt die de eerste twee resultaten van de bestaande query bevat.

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);
}

In dit voorbeeld worden vijf Product objecten opgehaald nadat de eerste drie in het queryresultaat zijn overgeslagen, gesorteerd op Product.ListPrice. Top wordt gebruikt in plaats van LIMIT voor paging.

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);
}

Opmerkingen

Top is niet-deterministisch, tenzij de query wordt gesorteerd.

Wanneer u de Top methode na de methode gebruikt, werkt deze Skip als de LIMIT-instructie van een ORDER BY-component .

Van toepassing op

Zie ook