DataServiceQuery<TElement>.IncludeTotalCount 方法

定義

命名空間:

System.Data.Services.Client

組件:

System.Data.Services.Client.dll

要求實體集中的所有實體計數以內嵌在查詢結果中的方式傳回。

public:
 System::Data::Services::Client::DataServiceQuery<TElement> ^ IncludeTotalCount();

public System.Data.Services.Client.DataServiceQuery<TElement> IncludeTotalCount ();

member this.IncludeTotalCount : unit -> System.Data.Services.Client.DataServiceQuery<'Element>

Public Function IncludeTotalCount () As DataServiceQuery(Of TElement)

傳回

DataServiceQuery<TElement>

已設定內嵌計數選項的新 DataServiceQuery<TElement> 物件。

範例

此範例會在呼叫 IncludeTotalCount 方法後執行查詢。 TotalCount 屬性是用於判斷查詢傳回的實體數目。

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Define a new query for Customers that includes the total count.
DataServiceQuery<Customer> query = context.Customers.IncludeTotalCount();

try
{
    // Execute the query for all customers and get the response object.
    QueryOperationResponse<Customer> response =
        query.Execute() as QueryOperationResponse<Customer>;

    // Retrieve the total count from the response.
    Console.WriteLine("There are a total of {0} customers.", response.TotalCount);

    // Enumerate the customers in the response.
    foreach (Customer customer in response)
    {
        Console.WriteLine("\tCustomer Name: {0}", customer.CompanyName);
    }
}
catch (DataServiceQueryException ex)
{
    throw new ApplicationException(
        "An error occurred during query execution.", ex);
}

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Define a new query for Customers that includes the total count.
Dim query As DataServiceQuery(Of Customer) = _
context.Customers.IncludeTotalCount()

Try
    ' Execute the query for all customers and get the response object.
    Dim response As QueryOperationResponse(Of Customer) = _
        CType(query.Execute(), QueryOperationResponse(Of Customer))

    ' Retrieve the total count from the response.
    Console.WriteLine("There are a total of {0} customers.", response.TotalCount)

    ' Enumerate the customers in the response.
    For Each customer As Customer In response
        Console.WriteLine(vbTab & "Customer Name: {0}", customer.CompanyName)
    Next
Catch ex As DataServiceQueryException
    Throw New ApplicationException( _
            "An error occurred during query execution.", ex)
End Try

備註

IncludeTotalCount呼叫 方法相當於在$inlinecount查詢 URI 中包含查詢選項。