共用方式為

傳回或略過序列中的項目

  • 發行項

使用 Take 運算子傳回序列中指定數目的項目，然後略過其餘的項目。

使用 Skip 運算子略過序列中指定數目的項目，然後傳回其餘的項目。

注意

Take 和 Skip 在用於對 SQL Server 2000 進行的查詢中時會有一些限制。 如需詳細資訊，請參閱疑難排解中的＜SQL Server 2000 中的 Skip 和 Take 例外狀況＞一節。

LINQ to SQL 會使用具有 SQL NOT EXISTS 子句的子查詢來轉譯 Skip。 這項轉譯具有下列限制：

  • 引數必須為集合。 即使多重集 (Multiset) 已排序，仍不支援多重集。

  • 產生的查詢可能會比已套用 Skip 之基底查詢所產生的查詢更為複雜。 這種複雜性會導致效能降低甚或逾時。

範例 1

下列範例會使用 Take 來選取前五名雇用的 Employees。 請注意，此集合會先按照 HireDate 排序。

IQueryable<Employee> firstHiredQuery =
    (from emp in db.Employees
    orderby emp.HireDate
    select emp)
    .Take(5);

foreach (Employee empObj in firstHiredQuery)
{
    Console.WriteLine("{0}, {1}", empObj.EmployeeID,
        empObj.HireDate);
}

Dim firstHiredQuery = _
    From emp In db.Employees _
    Select emp _
    Order By emp.HireDate _
    Take 5

For Each empObj As Employee In firstHiredQuery
    Console.WriteLine("{0}, {1}", empObj.EmployeeID, _
        empObj.HireDate)
Next

範例 2

下列範例會使用 Skip 來選取除了 10 項最貴 Products 以外的所有產品。

IQueryable<Product> lessExpensiveQuery =
    (from prod in db.Products
    orderby prod.UnitPrice descending
    select prod)
    .Skip(10);

foreach (Product prodObj in lessExpensiveQuery)
{
    Console.WriteLine(prodObj.ProductName);
}

Dim lessExpensiveQuery = _
    From prod In db.Products _
    Select prod _
    Order By prod.UnitPrice Descending _
    Skip 10

For Each prodObj As Product In lessExpensiveQuery
    Console.WriteLine(prodObj.ProductName)
Next

範例 3

下列範例會結合 Skip 和 Take 方法略過前 50 筆記錄，然後傳回接下來的 10 筆記錄。

var custQuery2 =
    (from cust in db.Customers
    orderby cust.ContactName
    select cust)
    .Skip(50).Take(10);

foreach (var custRecord in custQuery2)
{
    Console.WriteLine(custRecord.ContactName);
}

Dim custQuery2 = _
    From cust In db.Customers _
    Order By (cust.ContactName) _
    Select cust _
    Skip 50 _
    Take 10

For Each custRecord As Customer In custQuery2
    Console.WriteLine(custRecord.ContactName)
Next

Take 和 Skip 作業僅針對已排序的集合加以妥善定義。 並未定義未排序集合或多重集 (Multiset) 的語意 (Semantics)。

由於在 SQL 中排序的限制，LINQ to SQL 會嘗試將 Take 或 Skip 運算子的引數排序移至運算子的結果。

注意

SQL Server 2000 和 SQL Server 2005 的轉譯方式不同。 如果您打算使用 Skip 搭配具有任何複雜性的查詢，請使用 SQL Server 2005。

建議在 SQL Server 2000 使用下列 LINQ to SQL 查詢：

IQueryable<Customer> custQuery3 =
    (from custs in db.Customers
     where custs.City == "London"
     orderby custs.CustomerID
     select custs)
    .Skip(1).Take(1);

foreach (var custObj in custQuery3)
{
    Console.WriteLine(custObj.CustomerID);
}

Dim custQuery3 = _
    From custs In db.Customers _
    Where custs.City = "London" _
    Select custs _
    Order By custs.CustomerID _
    Skip 1 _
    Take 1

For Each custObj In custQuery3
    Console.WriteLine(custObj.CustomerID)
Next

LINQ to SQL 會將排序移至 SQL 程式碼的結尾，如下所示：

SELECT TOP 1 [t0].[CustomerID], [t0].[CompanyName],
FROM [Customers] AS [t0]
WHERE (NOT (EXISTS(
    SELECT NULL AS [EMPTY]
    FROM (
        SELECT TOP 1 [t1].[CustomerID]
        FROM [Customers] AS [t1]
        WHERE [t1].[City] = @p0
        ORDER BY [t1].[CustomerID]
        ) AS [t2]
    WHERE [t0].[CustomerID] = [t2].[CustomerID]
    ))) AND ([t0].[City] = @p1)
ORDER BY [t0].[CustomerID]

當 Take 和 Skip 鏈結在一起時，所有指定的排序都必須一致。 否則，會有未定義的結果。

至於以 SQL 規格為基礎的非負數、常數整數引數，Take 和 Skip 都已定義妥善。

另請參閱