LinqDataSource 類別

定義

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource

public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource

Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource

Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource

繼承

Object

Control

DataSourceControl

LinqDataSource

繼承

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

屬性

ToolboxBitmapAttribute

實作

IDynamicDataSource IDataSource

範例

下列範例顯示 LinqDataSource 從名為 的 Products 實體類別擷取資料的控制項。 實體類別可以使用 O/R Designer 或 SqlMetal.exe 公用程式來產生。 屬性 Where 設定為只傳回屬性中值大於 50 的 Price 記錄。 GridView控制項系結至 LinqDataSource 控制項以顯示資料。

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

下列範例顯示 LinqDataSource 可讓使用者在資料來源中更新、刪除和插入記錄的控制項。 DetailsView控制項會系結至 控制項， LinqDataSource 並讓使用者查看和修改資料。 請注意，不需要任何 SQL 命令，才能選取、更新、刪除或插入記錄。

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

下列範例顯示事件的事件處理常式 Selecting ，該事件會根據網頁中的值來設定資料物件。

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}

Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

下列範例顯示設定為依兩個 LinqDataSource 資料行分組的控制項。 屬性 Key 會參考具有兩個屬性和 ProductCategoryColor 的物件。 所 It 表示的物件會重新命名為 (別名) 。 Products 已重新命名 Products 的物件包含群組中個別記錄的集合。 每個實例都會包含資料表中的所有資料 Products 行。

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

下列範例顯示兩 ListView 個控制項，顯示上一個範例中控制項中的資料 LinqDataSource 。 其中一個控制項會顯示群組資料，另一個 ListViewListView 控制項會顯示屬於該群組的產品個別名稱。 巢狀資料繫結控制項的 DataSource 屬性會設定為 Products ，這是 物件的別名 It 。

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>

<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

備註

本主題內容：

• 簡介

• 運算順序

• 排序資料

• 分組資料

• 資料修改

• 在執行時間評估值

• 使用預存程式

• 宣告式語法

簡介

Language-Integrated Query (LINQ) 是一種查詢語法，可定義一組查詢運算子，讓周遊、篩選和投影作業在任何 中以宣告式方式表示。以 NET 為基礎的程式設計語言。 資料物件可以是記憶體內部資料收集，或代表資料庫資料的物件。 您可以擷取或修改資料，而不需要為每個作業撰寫 SQL 命令。

控制項 LinqDataSource 可讓您在 ASP.NET 網頁中使用 LINQ，方法是在標記文字中設定屬性。 控制項 LinqDataSource 會使用LINQ to SQL自動產生資料命令。 如需LINQ to SQL的詳細資訊，請參閱LINQ to SQL。

當您從記憶體內部資料收集擷取資料時，會將 屬性設定 ContextTypeName 為包含資料收集的類別。 您可以將 屬性設定 TableName 為傳回資料收集的屬性或欄位。 例如，您可能有名為 Person 的類別，其中包含名為 FavoriteCities 的屬性，該屬性會傳回字串值的陣列。 在此情況下，您會將 ContextTypeName 屬性設定為 Person ，並將 TableName 屬性設定為 FavoriteCities 。

當您查詢資料庫時，必須先建立代表資料庫及其資料表的實體類別。 您可以使用 物件關聯式設計工具 或 SqlMetal.exe 公用程式來產生這些類別。 然後， ContextTypeName 將 屬性設定為代表資料庫的 類別，並將 屬性設定 TableName 為代表資料庫資料表的屬性。

運算順序

控制項 LinqDataSource 會依下列順序套用資料作業：

1. 其中 (指定要傳回) 的資料記錄。

2. Order By (排序) 。

3. 群組依據 (匯總共用值的資料記錄) 。

4. 排序群組 依據 (排序群組資料) 。

5. 選取 (指定要傳回) 的欄位或屬性。

6. 自動排序 (依使用者選取) 的屬性來排序資料記錄。

7. 自動分頁 (擷取使用者) 選取的資料記錄子集。

您可以將條件新增至 屬性， Where 以篩選從查詢傳回的資料記錄。 Where如果未設定 屬性， LinqDataSource 控制項會從資料物件擷取每個記錄。

排序資料

您可以使用 OrderBy 屬性來指定要排序依據之傳回資料的屬性名稱。

分組資料

您可以使用 GroupBy 屬性來指定哪些屬性可用來合併具有相同值的資料記錄。 當您將資料分組時，您可以在 Key 屬性中包含 Select 和 It ，這些屬性是動態建立的屬性。 屬性 Key 是指用來分組資料之屬性或屬性中的值。 例如，如果您依名為 Category 的屬性分組，則 Key 屬性將包含 屬性中的所有 Category 唯一值。 屬性 It 是指資料群組中的個別記錄集合。 您可以逐一查看 It 屬性，以擷取群組作業中已合併的個別記錄。 例如，如果您依名為 Category 的屬性分組，則 It 屬性會包含屬性中 Category 共用通用值的所有個別記錄。

您可以使用 OrderGroupsBy 屬性來指定要用於排序群組資料的屬性。 當您將資料分組時， OrderBy 屬性會指定群組資料內個別記錄的排序方式。

根據預設， LinqDataSource 控制項會從資料物件擷取所有屬性的值。 Select如果您想要使用可用屬性的子集，您可以使用 屬性來指定要傳回的屬性。 選取作業會在 Where、Order By 和 Group By 作業之後套用。 因此，如果您在 Select 子句中建立別名名稱，則其他子句中無法使用別名。

資料修改

您可以使用 、 EnableInsert 和 EnableUpdate 屬性來指定是否啟用 EnableDelete 資料修改。 從控制項修改資料 LinqDataSource 的使用者介面通常是透過資料繫結控制項提供，例如 DetailsView 控制項。 除了將 、 EnableInsert 或 EnableUpdate 設定 EnableDelete 為 true 之外，還需要下列條件才能啟用自動資料修改：

• Select屬性無法指派值。

• GroupBy屬性無法指派值。

• 指派給 屬性的 ContextTypeName 類別必須衍生自 DataContext 。

• 指派給 TableName 屬性的屬性必須衍生自 Table<TEntity> 。

您可以透過兩種方式來限制哪些屬性以資料繫結控制項顯示。 您可以將 屬性設定 Select 為屬性的子集，也可以藉由新增 DataControlField 控制項來定義資料繫結控制項的欄位。 不過，如果您設定 Select 屬性，這表示無法啟用自動更新、插入和刪除作業。 如果您想要在使用可用屬性的子集時啟用自動資料修改，請勿設定 Select 屬性。 相反地，從資料物件擷取所有屬性，並使用資料系結控制項來管理要顯示的屬性。 當您使用 DetailsView 控制項或 GridView 控制項時，也必須將 AutoGenerateRows 或 AutoGenerateColumns 屬性設定為 false 。 這可防止資料系結控制項自動包含用於編輯和刪除資料的按鈕。 資料繫結控制項中未顯示的任何值都會儲存在檢視狀態中。 執行資料更新時，它們不會變更傳遞至資料來源。

在執行時間評估值

如果您必須在執行時間評估值以進行排序、篩選或群組值，您可以將參數新增至 WhereParameters 、 GroupByParameters 、 OrderGroupsByParameters 或 OrderByParameters 集合。

如果您想要指定預設值，您可以將參數新增至 InsertParameters 集合。

如果您想要在執行資料作業之前檢查或修改值，您可以處理 Deleting 、 Inserting 、 Selecting 或 Updating 事件。 您也可以處理這些事件，以取消資料作業，或檢查根據使用者輸入在資料類別中設定屬性時發生的驗證錯誤。

若要在資料作業完成之後檢查值，請處理 Deleted 、 Inserted 、 Selected 或 Updated 事件。

使用預存程式

LinqDataSource您可以使用 控制項，藉由建立 Selecting 事件的事件處理常式，從預存程式擷取資料。 在事件處理常式中，您會在代表預存程式的資料內容類別別中呼叫 方法，並將結果設定為 Result 物件的 屬性 LinqDataSourceSelectEventArgs 。 如果您想要啟用資料的自動更新、插入和刪除作業，則從 方法傳回的類型必須符合 屬性中指定的 TableName 類型。 如需建立資料內容方法的詳細資訊，請參閱如何：建立對應至預存程式和函式的 DataCoNtext 方法， (O/R Designer) 。

宣告式語法

<asp:LinqDataSource  
    AutoGenerateOrderByClause="True|False"  
    AutoGenerateWhereClause="True|False"  
    AutoPage="True|False"  
    AutoSort="True|False"  
    ContextTypeName="string"  
    EnableDelete="True|False"  
    EnableInsert="True|False"  
    EnableTheming="True|False"  
    EnableUpdate="True|False"  
    EnableViewState="True|False"  
    GroupBy="string"  
    ID="string"  
    OnContextCreated="ContextCreated event handler"  
    OnContextCreating="ContextCreating event handler"  
    OnContextDisposing="ContextDisposing event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnInserted="Inserted event handler"  
    OnInserting="Inserting event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelected="Selected event handler"  
    OnSelecting="Selecting event handler"  
    OnUnload="Unload event handler"  
    OnUpdated="Updated event handler"  
    OnUpdating="Updating event handler"  
    OrderBy="string"  
    runat="server"  
    Select="string"  
    SkinID="string"  
    StoreOriginalValuesInViewState="True|False"  
    TableName="string"  
    Visible="True|False"  
    Where="string"  
>  
        <GroupByParameters />  
        <InsertParameters />  
        <OrderByParameters />  
        <SelectParameters />  
        <WhereParameters />  
</asp:LinqDataSource>  

建構函式

屬性

方法

事件

明確介面實作

擴充方法

適用於

另請參閱

• LINQ to SQL