DataContext.GetCommand(IQueryable) 方法

定義

命名空間:
System.Data.Linq
組件:
System.Data.Linq.dll

取得由 LINQ 產生的 SQL 指令資訊。

public:
 System::Data::Common::DbCommand ^ GetCommand(System::Linq::IQueryable ^ query);
public System.Data.Common.DbCommand GetCommand(System.Linq.IQueryable query);
member this.GetCommand : System.Linq.IQueryable -> System.Data.Common.DbCommand
Public Function GetCommand (query As IQueryable) As DbCommand

參數

query
IQueryable

要取得 SQL 指令資訊的查詢。

傳回

DbCommand

請求的指令資訊物件。

範例

// using System.Data.Common;
Northwnd db = new Northwnd(@"c:\northwnd.mdf");

var q =
    from cust in db.Customers
    where cust.City == "London"
    select cust;

Console.WriteLine("Customers from London:");
foreach (var z in q)
{
    Console.WriteLine("\t {0}",z.ContactName);
}

DbCommand dc = db.GetCommand(q);
Console.WriteLine("\nCommand Text: \n{0}",dc.CommandText);
Console.WriteLine("\nCommand Type: {0}",dc.CommandType);
Console.WriteLine("\nConnection: {0}",dc.Connection);

Console.ReadLine();

' Imports System.Data.Common

Dim db As New Northwnd("c:\northwnd.mdf")

Dim q = _
From cust In db.Customers _
Where cust.City = "London" _
Select cust

Console.WriteLine("Customers from London:")
For Each z As Customer In q
    Console.WriteLine(vbTab & z.ContactName)
Next

Dim dc As DbCommand = db.GetCommand(q)
Console.WriteLine(Environment.NewLine & "Command Text: " & Environment.NewLine & dc.CommandText)
Console.WriteLine(Environment.NewLine & "Command Type: {0}", dc.CommandType)
Console.WriteLine(Environment.NewLine & "Connection: {0}", dc.Connection)

Console.ReadLine()

備註

此方法僅為 getter，不影響 DataContext 狀態。

請注意下列考量：

  • 該參數必須非零。 否則會拋出空參數例外。

  • 在 LINQ 執行到 SQL 查詢時，會觸發正常的查詢轉換異常，適用於無法被翻譯的查詢。

  • 只回傳第一個查詢指令。 具體來說，用於急切載入（LoadWith）的額外指令未包含在內。

  • DataContext 不會追蹤使用者使用該指令的行為。 例如，執行回傳指令的結果不會被追蹤，也不會影響 DataContext 狀態。

適用於