跟資料庫的資料互動時，您不會將 LinqDataSource 控制項直接連接到資料庫，而是與表示資料庫及表格的實體類別互動。您可以透過物件關聯式設計工具或透過執行 SqlMetal.exe 公用程式，來產生實體類別。如需詳細資訊，請參閱物件關聯式設計工具 (O/R 設計工具) 或程式碼產生工具 (SqlMetal.exe)。您建立的實體類別通常位於 Web 應用程式的 [App_Code] 資料夾中。O/R 設計工具或 SqlMetal.exe 公用程式會產生一個類別來表示資料庫，並且為資料庫的每個資料表產生一個類別。

表示資料庫的類別會負責擷取及設定資料來源中的值。表示資料表的類別則由 LinqDataSource 控制項來讀取及設定其屬性。資料庫類別必須衍生自 DataContext 類別，資料表類別必須參考至 Table<(Of <(TEntity>)>) 類別，才能支援更新、插入及刪除作業。

您可以將 ContextTypeName 屬性設定成表示資料庫的類別名稱，將 LinqDataSource 控制項連接到資料庫類別。您可以藉由將 TableName 屬性設定成表示資料的資料表 (Data Table) 的類別名稱，將 LinqDataSource 控制項連接到特定資料表。舉例來說，若要連接到 AdventureWorks 資料庫裡的 [連絡人] 資料表，可將 ContextTypeName 屬性設定成 AdventureWorksDataContext (或您為資料庫物件指定的任何名稱)。將 TableName 屬性設定為 Contacts。下列範例中的標記就是連接到 AdventureWorks 資料庫的 LinqDataSource 控制項的標記。

<asp:LinqDataSource 
    ContextTypeName="AdventureWorksDataContext" 
    TableName="Contacts" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>

由於 O/R 設計工具產生的程式碼太長，因此本範例未顯示它產生的類別。但是，本範例需要有產生的程式碼，才能順利執行。如需詳細資訊，請參閱 LINQ to SQL 的程式碼產生。

連接到記憶體中資料集合 (如陣列) 時，請將 ContextTypeName 屬性設定成集合所屬類別的名稱。將 TableName 屬性設定成集合本身的名稱。

下列範例顯示包含字串值陣列的類別。

Public Class MovieLibrary
    Dim _availableGenres() As String = {"Comedy", "Drama", "Romance"}

    Public ReadOnly Property AvailableGenres() As String()
        Get
            Return _availableGenres
        End Get
    End Property

End Class

public class MovieLibrary
{
    string[] _availableGenres = { "Comedy", "Drama", "Romance" };

    public MovieLibrary()
    {
    }

    public string[] AvailableGenres
    {
        get
        {
            return _availableGenres;
        }
    }
}

下列範例顯示 LinqDataSource 控制項，該控制項會從前一個範例中的類別讀取影片類型的清單。若要擷取類型的陣列，請將 ContextTypeName 屬性設定為 MovieLibrary，並將 TableName 屬性設定為 AvailableGenres。

<asp:LinqDataSource 
    ContextTypeName="MovieLibrary" 
    TableName="AvailableGenres" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>

若要顯示 LinqDataSource 控制項中的資料，您可以將資料繫結控制項繫結到 LinqDataSource 控制項。例如，把 DetailsView 控制項、GridView 控制項或 ListView 控制項繫結到 LinqDataSource 控制項。做法是將資料繫結控制項的 DataSourceID 屬性設定成 LinqDataSource 控制項的 ID。下列範例中的 GridView 控制項即可顯示 LinqDataSource 控制項中的所有資料。

<asp:LinqDataSource 
    runat="server"
    ContextTypeName="AdventureWorksDataContext" 
    TableName="Contacts" 
    ID="LinqDataSource1">
</asp:LinqDataSource>
<asp:GridView 
    ID="GridView1" 
    runat="server"
    DataSourceID="LinqDataSource1" >
</asp:GridView>

資料繫結控制項會自動建立使用者介面來顯示 LinqDataSource 控制項中的資料。它也會提供資料排序及資料分頁所需的介面。啟用資料修改功能時，資料繫結控制項會提供讓您更新、插入及刪除記錄的介面。

您可以將資料繫結控制項設定成不要自動產生資料控制項欄位，以限制要顯示的資料 (屬性)。之後，您就能在資料繫結控制項中明確定義這些欄位。LinqDataSource 控制項會擷取所有屬性，但資料繫結控制項僅顯示您指定的屬性。下列範例中的 GridView 控制項只顯示 AdventureWorks 資料庫裡 [產品] 資料表中的 Name 及 StandardCost 屬性。AutoGenerateColumns 屬性設定為 false。

<asp:LinqDataSource 
    ContextTypeName="AdventureWorksDataContext" 
    TableName="Products" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1" 
    AutoGenerateColumns="false"
    ID="GridView1" 
    runat="server">
    <Columns>
        <asp:BoundField DataField="Name" />
        <asp:BoundField DataField="StandardCost" />
    </Columns>
</asp:GridView>

如果要限制查詢時要傳回哪些屬性，請設定 LinqDataSource 控制項的 Select 屬性來定義要傳回的屬性。

跟使用 SqlDataSource 或 ObjectDataSource 控制項相比，使用 LinqDataSource 控制項來執行資料作業時所需要撰寫的程式碼比較少。LinqDataSource 控制項會推斷您要連接之資料來源的資訊，並動態建立用於選取、更新、插入及刪除資料的命令。當您使用 LinqDataSource 控制項時，也必須學習一種程式設計模型，與各類資料來源互動。

比較 SqlDataSource 控制項

比較 ObjectDataSource 控制項

如果您沒有指定 LinqDataSource 控制項之 Select 屬性的值，則會擷取資料來源類別中的所有屬性。例如，LinqDataSource 控制項會針對資料庫資料表的每一個資料行傳回一個值。

您可以將 Select 屬性設定成您要的屬性名稱，即可限制要從資料來源擷取哪些屬性。如果只想傳回一個屬性，請將 Select 屬性設定為該屬性。例如，您只想傳回資料庫資料表裡 City 資料行中的值，則請將 Select 屬性設定為 City。LinqDataSource 控制項會傳回一個 List<(Of <(T>)>) 集合，其中包含該屬性中正確輸入的項目。如果 City 屬性是以文字 (字串) 輸入，則選取 City 屬性便會傳回字串值的 List<(Of <(T>)>) 集合。

如果只想擷取資料類別中的某些屬性，請用 Select 屬性中的 new 功能，並指定要傳回的資料行。您將動態建立一個類別，其中只包含您已指定的屬性，因此 new 功能是必要的。例如，資料來源內有完整的地址，但您只想擷取其中的 City 及 PostalCode 屬性，那麼請將 Select 屬性設定為 new(City, PostalCode)。LinqDataSource 控制項會傳回一個 List<(Of <(T>)>) 集合，其中包含一個包括那些屬性之類別的執行個體。

若只選取一個屬性，則不必使用 new 功能，因為傳回的物件是該屬性之值的簡單集合。但選取多個屬性時，LinqDataSource 控制項必須建立新類別，以包含您指定的屬性。

用 Select 子句來計算值

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="OrderDetails" 
    Select="new(SalesOrderDetailID As DetailID, 
      OrderQty * UnitPrice As LineItemTotal, 
      DateCreated As SaleDate)"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>

您可以篩選傳回的值，以便僅擷取出符合特定準則的記錄。您可以將 Where 屬性設定為一些條件，而記錄要符合這些條件才能包含在傳回的值中。如未指定 Where 屬性的值，則會擷取資料來源裡的所有記錄。您可以藉由建立篩選運算式來進行篩選，此運算式會利用比較來決定是否要包括某項記錄。它可以比較靜態值，也可以比較您用參數替代符號 (Placeholder) 指定的變數值。

用靜態值建立 Where 子句

<asp:LinqDataSource
  ContextTypeName="ExampleDataContext"
  TableName="Product"
  Where='Category = "Sports" && Weight < 10'
  ID="LinqDataSource1"
  runat="server"
</asp:LinqDataSource>

建立參數型 Where 子句

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
  <asp:ListItem Value="Sports">Sports</asp:ListItem>
  <asp:ListItem Value="Garden">Garden</asp:ListItem>
  <asp:ListItem Value="Auto">Auto</asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateWhereClause="true"
    ID="LinqDataSource1" 
    runat="server">
  <WhereParameters>
    <asp:ControlParameter 
      Name="Category" 
      ControlID="DropDownList1" 
      Type="String" />
  </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList 
    AutoPostBack="true" 
    ID="DropDownList1" 
    runat="server">
  <asp:ListItem Value="0">0</asp:ListItem>
  <asp:ListItem Value="25">25</asp:ListItem>
  <asp:ListItem Value="100">100</asp:ListItem>
  <asp:ListItem Value="400">400</asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > @UserPrice"
    ID="LinqDataSource1" 
    runat="server">
  <WhereParameters>
    <asp:ControlParameter 
      Name="UserPrice" 
      DefaultValue="0" 
      ControlID="DropDownList1" 
      Type="Int32" />
  </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

您可以將資料分組，把在一個或多個資料行中具有共同值的記錄資料進行合併彙算。您可以將 GroupBy 屬性設定為要用來合併彙算資料的屬性名稱。例如，資料表包含地址資訊，而您想依相同的城市值將記錄分組，則可將 GroupBy 設定為 City。

將 GroupBy 屬性與彙總功能一起使用，即可針對分組後的資料計算值，如某屬性的平均值或總和。您會透過參考 Key 物件來擷取要用於分組的值。

下列範例顯示如何將名為 ProductCategory 的屬性上之資料分組。將 Key 包含在 Select 屬性中，以擷取分組的值。Select 屬性中亦包括 Average 及 Count 彙總方法。

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="ProductCategory"
  Select="new(Key, 
    Average(ListPrice) As AverageListPrice, 
    Average(Cost) As AverageCost, 
    Count() As RecordCount)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

您可以使用 It 關鍵字來擷取屬於同一群組的個別記錄。如需詳細資訊，請參閱 HOW TO：使用 LinqDataSource 控制項分組和彙總資料。

彙總方法

您可以設定讓 LinqDataSource 控制項自動建立用於更新、刪除和插入資料的命令。若要啟用自動資料更新，請將 EnableUpdate、EnableInsert 或 EnableDelete 屬性設定為 true。

注意事項：
如果希望 LinqDataSource 控制項自動產生更新命令，請勿設定 Select 屬性。Select 屬性已設定時，LinqDataSource 控制項會傳回一個物件，這個物件是一個動態類別的執行個體。不是表示資料庫資料表之類別的執行個體。因此，動態類別無法推斷如何更新資料庫資料表中的值。

如果您想透過程式設計方式來設定任何要更新的值，可以建立 Updating、Inserting 或 Deleting 事件的事件處理常式。在處理常式中，您可以於資料作業開始前，先設定一個值。如需詳細資訊，請參閱 HOW TO：使用 LinqDataSource 控制項更新、插入和刪除資料。

LinqDataSource 物件可以用兩種方式排序查詢中的資料。開發 Web 網頁時，您可以用靜態值排序資料。之後可以讓使用者在執行階段動態排序資料。

若要依靜態值排序資料，請將屬性名稱指派給 OrderBy 屬性。若要讓使用者在執行階段排序資料，請將 AutoSort 屬性設定為 true (預設值)。然後把排序運算式傳遞到 LinqDataSource 控制項。當資料繫結控制項的 AllowSorting 屬性設定為 true 時，資料繫結控制項 (如 GridView 控制項) 就會傳遞排序運算式。

若要在 OrderBy 屬性中指定一個以上的資料行名稱，請以逗號分隔各名稱。舉例來說，如果指定 "LastName, FirstName"，則會先依 LastName 將記錄排序，記錄的 LastName 欄位中如果有相符值，再依 FirstName 來排序。

如果想先以特定順序傳回資料，再讓使用者變更順序，則可同時使用這兩種排序方法。此時請將 AutoSort 屬性設定為 true，並將 OrderBy 屬性設定為屬性名稱。

下列範例中的 LinqDataSource 控制項先依 LastName、再依 FirstName，然後再依 MiddleName 排序記錄。LinqDataSource 控制項也設定成可以讓使用者動態地排序資料列。您可以將資料控制項 (如 GridView 控制項) 繫結到 LinqDataSource 控制項來顯示資料，並讓使用者指定排列順序。

<asp:LinqDataSource
  ContextTypeName="ExampleDataContext"
  TableName="Contact"
  OrderBy="LastName, FirstName, MiddleName"
  AutoSort="true"
  ID="LinqDataSource1"
  runat="server"
</asp:LinqDataSource>

當您使用 LinqDataSource 控制項時，可用參數指定必須在執行階段解譯及轉換哪些值。與其他資料來源控制項不同的是，您不必指定更新、插入或刪除作業中的每一個值。LinqDataSource 控制項會自動設定這些值，並使用 LINQ to SQL 產生 SQL 命令。您指定的參數僅會做為預設值或轉換空值之用。您也可以用 WhereParameters 及 OrderByParameters 參數集合，根據執行階段的值來排序或篩選資料。如需 LINQ to SQL 的詳細資訊，請參閱 LINQ to SQL。

LinqDataSource 控制項包含下列參數集合：

• DeleteParameters

• GroupByParameters

• InsertParameters

• OrderByParameters

• SelectParameters

• UpdateParameters

• WhereParameters.

有關如何使用 WhereParameters 集合讓使用者動態篩選從 LinqDataSource 控制項所傳回記錄的範例，請見本主題中稍早提及的使用 Where 子句篩選資料。

即使使用者可以更新或刪除資料，您也希望能在更新或刪除之前，先確保並沒有其他處理序已經變更了資料來源的資料。如果不檢查這些值是否已改變，則可能會不小心覆寫其他處理序設定的值，導致資料不一致。

LinqDataSource 控制項可以協助您判斷資料是否已改變。此控制項會將原始資料值以檢視狀態儲存在 Web 網頁中。Web 網頁張貼回來時，頁面會包含原始值及所有更新值。LinqDataSource 控制項會使用 LINQ to SQL 比較原始值跟目前位於資料來源的值。值如果相同，表示資料未變更，LINQ to SQL 就會更新或刪除資料。如果資料已變更，LINQ to SQL 會引發例外狀況。

您可以設定實體類別裡資料行的 UpdateCheck 屬性，來手動指定要檢查哪些資料行的值。O/R 設計工具在產生資料庫資料表的程式碼時，會將資料庫所管理資料行的 UpdateCheck 屬性設定為 Never。其他資料行的值則設定為 Always，表示該資料行永遠要進行並行存取檢查。將資料行的 UpdateCheck 屬性設定為 Never，可以避免將資料行納入並行存取檢查。此外，將屬性設定為 Never 還可避免該資料行的值以檢視狀態儲存。請只在使用者已變更該值時，才將 UpdateCheck 屬性設定為 WhenChanged 以便根據資料來源檢查值。

如果您必須以檢視狀態儲存敏感性資料，請加密檢視狀態。如需詳細資訊，請參閱在 ASP.NET 2.0 中加密 ViewState (英文)。

注意事項：
加密檢視狀態可能會影響 Web 網頁的效能。

為 SQL Server 資料最佳化並行存取檢查

若要使用 LinqDataSource 控制項從預存程序 (Stored Procedure) 中擷取資料，請為 Selecting 事件建立處理常式。在事件處理常式中，您會呼叫代表預存程序的資料內容類別方法。然後，將預存程序的結果設定為 LinqDataSourceSelectEventArgs 物件的 Result 屬性。如果您想要啟用自動更新、插入與刪除作業，則從方法傳回的型別必須符合 TableName 屬性中指定的型別。

下列範例示範如何將 Result 屬性指派給從方法 (表示預存程序) 傳回的物件。

Protected Sub LinqDataSource_Selecting(ByVal sender As Object, _
        ByVal e As LinqDataSourceSelectEventArgs)
    Dim exampleContext As ExampleDataContext = New ExampleDataContext()
    e.Result = exampleContext.GetRegisteredCustomers()
End Sub

protected void LinqDataSource_Selecting(object sender, 
        LinqDataSourceSelectEventArgs e)
{
    ExampleDataContext exampleContext = new ExampleDataContext();
    e.Result = exampleContext.GetRegisteredCustomers();
}

如需建立資料內容方法的詳細資訊，請參閱 HOW TO：建立對應到預存程序和函式的 DataContext 方法 (O/R 設計工具)。

在您修改資料錄之前，可能需要先驗證值。一般來說，您會將驗證檢查納入資料類別中，而不是納入 Web 網頁。當您在資料類別中集中處理驗證檢查時，不管資料類別使用方式為何，請務必確認可以使用驗證檢查。如需如何將驗證加入至類別的詳細資訊，請參閱 HOW TO：將驗證加入至實體類別和逐步解說：將驗證加入至實體類別。

驗證例外狀況會在資料更新、插入或刪除之前擲回。若要擷取驗證例外狀況，您可以為 Inserting、Updating 和 Deleting 事件建立處理常式。如需詳細資訊，請參閱 LinqDataSourceUpdateEventArgs、LinqDataSourceInsertEventArgs 和 LinqDataSourceDeleteEventArgs 類別。

LinqDataSource 控制項會在處理期間，於特定時間點引發事件，讓您自訂如何選取、插入、更新或刪除資料。

LinqDataSource 控制項在選取資料時，會依序引發下列事件：

1. Selecting

2. ContextCreating (如有需要)

3. ContextCreated (如有需要)

4. Selected

5. ContextDisposing

如果您以程式設計的方式建立 Selecting 事件中的內容物件，而不必以檢視狀態儲存原始值時，ContextCreating 和 ContextCreated 事件會略過。

LinqDataSource 控制項在更新、插入或刪除資料時，會依序引發下列事件：

1. ContextCreating

2. ContextCreated

3. Inserting 或 Updating 或 Deleting

4. Inserted 或 Updated 或 Deleted

5. ContextDisposing

更新、刪除和插入作業的事件順序跟選取作業不同。這是因為 LinqDataSource 控制項必須取得資料物件的執行個體，並將該執行個體傳遞到 Inserting、Updating 或 Deleting 事件。

資料作業執行之前，會引發 Selecting、Inserting、Updating 及 Deleting 事件。您為這些事件建立的事件處理常式會在作業之前驗證或修改值，或取消作業。舉例來說，如果資料庫裡有一個資料行，用來儲存上次修改記錄的使用者，您就可以透過程式設計的方式，使用 Updating 事件設定使用者名稱值。

作業結束後，會引發 Selected、Inserted、Updated 及 Deleted 事件。您為這些事件建立的事件處理常式會攔截例外狀況，並檢查作業傳回的值。

LinqDataSource 控制項在建立 ContextTypeName 屬性中指定的型別之前，會引發 ContextCreating 事件。如果您要以程式設計的方式建立內容型別，就要處理這個事件。舉例來說，如果內容型別的建構函式 (Constructor) 方法需要參數，您就需要處理這個事件。ContextTypeName 屬性中指定的型別建立後，會引發 ContextCreated 事件。您可以處理這個事件，來攔截例外狀況或檢查已建立的內容物件。LinqDataSource 控制項在處置 ContextTypeName 屬性中指定的內容型別之前，會引發 ContextDisposing 事件。您必須處理這個事件，以取消處置必須花費很多時間或資源才能建立的物件。您也可以用這個事件，在物件被終結之前，執行該物件特有的清除作業。

回到頁首