共用方式為


LinqDataSource 類別

定義

在 ASP.NET 網頁中透過標記文字啟用 Language-Integrated Query (LINQ),以從資料物件擷取和修改資料。

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
繼承
繼承
屬性
實作

範例

下列範例顯示 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 屬性來指定要排序依據之傳回資料的屬性名稱。

注意

當您使用 LinqDataSource 控制項搭配 SQL Server 2000 或 SQL Server Compact 3.5,且 AutoPage 屬性設定 true 為 時,您必須在 OrderBy 屬性中提供值。 根據預設, AutoPage 屬性為 true 。 如果您將值指派給 Select 屬性,您也必須在查詢中傳回的屬性清單中包含所有識別資料行。

分組資料

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

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

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

資料修改

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

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

在執行時間評估值

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

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

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

若要在資料作業完成之後檢查值,請處理 DeletedInsertedSelectedUpdated 事件。

使用預存程式

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>  

建構函式

LinqDataSource()

初始化 LinqDataSource 類別的新執行個體。

屬性

Adapter

針對控制項取得瀏覽器的特定配置器。

(繼承來源 Control)
AppRelativeTemplateSourceDirectory

取得或設定包含了此控制項之 PageUserControl 物件的相對應用程式虛擬目錄。

(繼承來源 Control)
AutoGenerateOrderByClause

取得或設定值,指出 LinqDataSource 控制項是否會根據 OrderByParameters 集合中的值,動態建立 ORDER BY 子句。

AutoGenerateWhereClause

取得或設定值,這個值表示 LinqDataSource 控制項是否根據 WhereParameters 集合中所定義的值動態地建立 Where 子句。

AutoPage

取得或設定值,指出 LinqDataSource 控制項是否支援在執行階段完整瀏覽資料的區段。

AutoSort

取得或設定值,指出 LinqDataSource 控制項是否支援在執行階段排序資料。

BindingContainer

取得包含了此控制項之資料繫結的控制項。

(繼承來源 Control)
ChildControlsCreated

取得值,指出是否已經建立伺服器控制項的子控制項。

(繼承來源 Control)
ClientID

取得 ASP.NET 產生的伺服器控制項識別項。

(繼承來源 DataSourceControl)
ClientIDMode

這個屬性不會用於資料來源控制項。

(繼承來源 DataSourceControl)
ClientIDSeparator

取得字元值,表示在 ClientID 屬性中所使用的分隔字元。

(繼承來源 Control)
Context

取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。

(繼承來源 Control)
ContextTypeName

取得或設定型別的名稱,該型別所包含之屬性的值具有您要擷取的資料。

Controls

取得 ControlCollection 物件,表示 UI 階層架構中指定之伺服器控制項的子控制項。

(繼承來源 DataSourceControl)
DataItemContainer

如果命名容器實作 IDataItemContainer,則取得命名容器的參考。

(繼承來源 Control)
DataKeysContainer

如果命名容器實作 IDataKeysControl,則取得命名容器的參考。

(繼承來源 Control)
DeleteParameters

LinqDataSource 類別不使用這個屬性。

DesignMode

取得值,指出控制項是否正用於設計介面上。

(繼承來源 Control)
EnableDelete

取得或設定值,這個值表示是否可以透過 LinqDataSource 控制項刪除資料錄。

EnableInsert

取得或設定值,這個值表示是否可以透過 LinqDataSource 控制項插入資料錄。

EnableObjectTracking

取得或設定值,這個值表示是否追蹤資料內容物件的變更。

EnableTheming

取得值,指出這個控制項是否支援佈景主題。

(繼承來源 DataSourceControl)
EnableUpdate

取得或設定值,這個值表示是否可以透過 LinqDataSource 控制項更新資料錄。

EnableViewState

取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。

(繼承來源 Control)
EntitySetName

取得或設定資料來源物件中屬性或欄位的名稱,這個物件表示資料集合。

(繼承來源 ContextDataSource)
EntityTypeName

取得或設定針對 Insert、Delete 和 Update 作業建立的型別名稱。

(繼承來源 ContextDataSource)
Events

取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。

(繼承來源 Control)
GroupBy

取得或設定值,這個值指定用於對擷取的資料進行分組的屬性。

GroupByParameters

取得用於建立 Group By 子句的參數集合。

HasChildViewState

取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。

(繼承來源 Control)
ID

取得或設定指派給伺服器控制項的程式設計識別項。

(繼承來源 Control)
IdSeparator

取得用來分隔控制項識別項的字元。

(繼承來源 Control)
InsertParameters

取得插入作業期間所使用的參數集合。

IsChildControlStateCleared

取得值,指出這個控制項中所包含的控制項是否有控制項狀態。

(繼承來源 Control)
IsTrackingViewState

取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。

(繼承來源 Control)
IsViewStateEnabled

取得值,指出這個控制項是否已啟用檢視狀態。

(繼承來源 Control)
LoadViewStateByID

取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。

(繼承來源 Control)
NamingContainer

取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 ID 屬性值的伺服器控制項之間作區別。

(繼承來源 Control)
OrderBy

取得或設定值,這個值指定用於對擷取之資料進行排序的欄位。

OrderByParameters

取得用於建立 Order By 子句的參數集合。

OrderGroupsBy

取得或設定用於排序分組資料的欄位。

OrderGroupsByParameters

取得用來建立 Order Groups By 子句的參數集合。

Page

取得含有伺服器控制項的 Page 執行個體的參考。

(繼承來源 Control)
Parent

在網頁控制階層架構中取得伺服器控制項之父控制項的參考。

(繼承來源 Control)
RenderingCompatibility

取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。

(繼承來源 Control)
Select

取得或設定屬性以及擷取之資料中包含的計算值。

SelectParameters

取得擷取資料作業期間所使用的參數集合。

Site

當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。

(繼承來源 Control)
SkinID

取得套用至 DataSourceControl 控制項的面板。

(繼承來源 DataSourceControl)
StoreOriginalValuesInViewState

取得或設定值,這個值表示資料來源的資料是否應在檢視狀態中進行儲存,以確定在更新或刪除資料前,資料未由另一個處理序變更。

TableName

取得或設定資料內容類別中屬性或欄位的名稱,這個類別表示資料集合。

TemplateControl

取得或設定包含了此控制項之樣板的參考。

(繼承來源 Control)
TemplateSourceDirectory

取得包含目前伺服器控制項的 PageUserControl 的虛擬目錄。

(繼承來源 Control)
UniqueID

取得伺服器控制項唯一的、符合階層架構的識別項。

(繼承來源 Control)
UpdateParameters

LinqDataSource 類別不使用這個集合。

ValidateRequestMode

取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。

(繼承來源 Control)
ViewState

取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。

(繼承來源 Control)
ViewStateIgnoresCase

取得值,指出 StateBag 物件是否不區分大小寫。

(繼承來源 Control)
ViewStateMode

取得或設定這個控制項的檢視狀態模式。

(繼承來源 Control)
Visible

取得或設定值,指出是否視覺化顯示控制項。

(繼承來源 DataSourceControl)
Where

取得或設定值,這個值指定針對要併入擷取之資料的資料錄,必須為 true 的條件。

WhereParameters

取得用於建立 Where 子句的參數集合。

方法

AddedControl(Control, Int32)

在子控制項加入 Control 物件的 Controls 集合後呼叫。

(繼承來源 Control)
AddParsedSubObject(Object)

通知伺服器控制項,XML 或 HTML 項目已剖析,並將項目加入伺服器控制項的 ControlCollection 物件中。

(繼承來源 Control)
ApplyStyleSheetSkin(Page)

將頁面樣式表中所定義的樣式屬性套用至控制項。

(繼承來源 DataSourceControl)
BeginRenderTracing(TextWriter, Object)

開始進行轉譯資料的設計階段追蹤。

(繼承來源 Control)
BuildProfileTree(String, Boolean)

收集伺服器控制項的相關資訊,並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。

(繼承來源 Control)
ClearCachedClientID()

將快取的 ClientID 值設定為 null

(繼承來源 Control)
ClearChildControlState()

刪除伺服器控制項之子控制項的控制項狀態資訊。

(繼承來源 Control)
ClearChildState()

刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。

(繼承來源 Control)
ClearChildViewState()

刪除所有伺服器控制項之子控制項的檢視狀態資訊。

(繼承來源 Control)
ClearEffectiveClientIDMode()

將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 Inherit

(繼承來源 Control)
CreateChildControls()

由 ASP.NET 網頁架構呼叫,通知使用組合實作的伺服器控制項來建立所包含的任何子控制項,以準備回傳或呈現。

(繼承來源 Control)
CreateControlCollection()

建立儲存子控制項的集合。

(繼承來源 DataSourceControl)
CreateQueryableView()

傳回可查詢的檢視。

CreateView()

建立與這個控制項關聯之 LinqDataSourceView 類別的新執行個體。

DataBind()

將資料來源繫結至所叫用的伺服器控制項及其所有子控制項。

(繼承來源 Control)
DataBind(Boolean)

使用會引發 DataBinding 事件的選項,繫結資料來源至叫用的伺服器控制項及其所有子控制項。

(繼承來源 Control)
DataBindChildren()

繫結資料來源至伺服器控制項的子控制項。

(繼承來源 Control)
Delete(IDictionary, IDictionary)

執行刪除作業。

Dispose()

啟用伺服器控制項,在它從記憶體釋放之前執行最後清除。

(繼承來源 Control)
EndRenderTracing(TextWriter, Object)

結束轉譯資料的設計階段追蹤。

(繼承來源 Control)
EnsureChildControls()

判斷伺服器控制項是否包含子控制項。 如果不包含,則建立子控制項。

(繼承來源 Control)
EnsureID()

為尚未指定識別項的控制項,建立識別項。

(繼承來源 Control)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
FindControl(String)

在目前命名容器搜尋具有指定 id 參數的伺服器控制項。

(繼承來源 DataSourceControl)
FindControl(String, Int32)

使用指定的 id 和有助於搜尋之 pathOffset 參數中所指定的整數,在目前的命名容器中搜尋伺服器控制項。 您不應該覆寫這個版本的 FindControl 方法。

(繼承來源 Control)
Focus()

設定控制項的輸入焦點。

(繼承來源 DataSourceControl)
GetDesignModeState()

取得控制項的設計階段資料。

(繼承來源 Control)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetRouteUrl(Object)

取得會對應於一組路由參數的 URL。

(繼承來源 Control)
GetRouteUrl(RouteValueDictionary)

取得會對應於一組路由參數的 URL。

(繼承來源 Control)
GetRouteUrl(String, Object)

取得 URL,此 URL 對應於一組路由參數及一個路由名稱。

(繼承來源 Control)
GetRouteUrl(String, RouteValueDictionary)

取得 URL,此 URL 對應於一組路由參數及一個路由名稱。

(繼承來源 Control)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
GetUniqueIDRelativeTo(Control)

傳回指定之控制項 UniqueID 屬性的前置部分。

(繼承來源 Control)
GetView(String)

傳回與 LinqDataSource 物件建立關聯的資料來源檢視。

GetView(String)

取得與 QueryableDataSource 物件相關聯的資料來源檢視。

(繼承來源 QueryableDataSource)
GetViewNames()

傳回名稱集合,代表與 LinqDataSource 控制項建立關聯之檢視物件的清單。

GetViewNames()

取得名稱集合,這些名稱表示與 QueryableDataSource 控制項相關聯的檢視。

(繼承來源 QueryableDataSource)
HasControls()

判斷伺服器控制項是否包含任何子控制項。

(繼承來源 DataSourceControl)
HasEvents()

傳回值,指出控制項或任何子控制項的事件是否已註冊。

(繼承來源 Control)
Insert(IDictionary)

執行插入作業。

IsLiteralContent()

判斷伺服器控制項是否只儲存常值內容。

(繼承來源 Control)
LoadControlState(Object)

SaveControlState() 方法所儲存的上一頁要求中,還原控制項狀態資訊。

(繼承來源 Control)
LoadViewState(Object)

載入 LinqDataSource 控制項中必須保存的值狀態。

LoadViewState(Object)

載入 QueryableDataSource 控制項中必須保存的值狀態。

(繼承來源 QueryableDataSource)
MapPathSecure(String)

擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。

(繼承來源 Control)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
OnBubbleEvent(Object, EventArgs)

決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。

(繼承來源 Control)
OnDataBinding(EventArgs)

引發 DataBinding 事件。

(繼承來源 Control)
OnInit(EventArgs)

初始化 LinqDataSource 物件。

OnLoad(EventArgs)

引發 Load 事件。

(繼承來源 Control)
OnPreRender(EventArgs)

引發 PreRender 事件。

(繼承來源 Control)
OnUnload(EventArgs)

引發 Unload 事件。

OpenFile(String)

取得用來讀取檔案的 Stream

(繼承來源 Control)
RaiseBubbleEvent(Object, EventArgs)

指派事件的任何來源和它的資訊至控制項的父控制項。

(繼承來源 Control)
RaiseDataSourceChangedEvent(EventArgs)

引發 DataSourceChanged 事件。

(繼承來源 DataSourceControl)
RaiseViewChanged()

呼叫 OnDataSourceViewChanged(EventArgs) 類別的 DataSourceView 方法。

(繼承來源 QueryableDataSource)
RemovedControl(Control)

Control 物件的 Controls 集合中移除子控制項之後呼叫。

(繼承來源 Control)
Render(HtmlTextWriter)

將伺服器控制項內容傳送到提供的 HtmlTextWriter 物件,以寫入要在用戶端上呈現的內容。

(繼承來源 Control)
RenderChildren(HtmlTextWriter)

將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件,再由這個物件在用戶端上寫入要轉譯的內容。

(繼承來源 Control)
RenderControl(HtmlTextWriter)

將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件,並在啟用追蹤時儲存控制項的追蹤資訊。

(繼承來源 DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 HtmlTextWriter 物件,輸出伺服器控制項內容至提供的 ControlAdapter 物件。

(繼承來源 Control)
ResolveAdapter()

取得負責呈現指定之控制項的控制項配置器。

(繼承來源 Control)
ResolveClientUrl(String)

取得瀏覽器可使用的 URL。

(繼承來源 Control)
ResolveUrl(String)

將 URL 轉換為要求用戶端可使用的 URL。

(繼承來源 Control)
SaveControlState()

儲存頁面回傳至伺服器以來,所發生的任何伺服器控制項狀態變更。

(繼承來源 Control)
SaveViewState()

儲存 LinqDataSource 控制項的目前檢視狀態。

SaveViewState()

儲存 QueryableDataSource 控制項的目前檢視狀態。

(繼承來源 QueryableDataSource)
SetDesignModeState(IDictionary)

設定控制項的設計階段資料。

(繼承來源 Control)
SetRenderMethodDelegate(RenderMethod)

指定事件處理常式委派,以呈現伺服器控制項及其內容至其父控制項。

(繼承來源 Control)
SetTraceData(Object, Object)

使用追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。

(繼承來源 Control)
SetTraceData(Object, Object, Object)

使用追蹤的物體、追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。

(繼承來源 Control)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
TrackViewState()

追蹤 LinqDataSource 控制項的檢視狀態變更,以便變更可以儲存在控制項的 StateBag 物件中。

TrackViewState()

追蹤 QueryableDataSource 控制項的檢視狀態變更,以將變更儲存於控制項的 StateBag 物件中。

(繼承來源 QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

執行更新作業。

UpdateParameterVales()

更新自上一個要求後變更的參數值。

(繼承來源 QueryableDataSource)

事件

ContextCreated

在建立內容型別物件的執行個體之後發生。

ContextCreating

在建立內容型別物件的執行個體之前發生。

ContextDisposing

在處置內容型別物件之前發生。

DataBinding

發生於伺服器控制項繫結至資料來源時。

(繼承來源 Control)
Deleted

在刪除作業完成時發生。

Deleting

在刪除作業之前發生。

Disposed

發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。

(繼承來源 Control)
Init

發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。

(繼承來源 Control)
Inserted

在插入作業完成時發生。

Inserting

在插入作業之前發生。

Load

發生於載入伺服器控制項至 Page 物件時。

(繼承來源 Control)
PreRender

Control 物件載入之後但在呈現之前發生。

(繼承來源 Control)
QueryCreated

在資料來源控制項中加入或移除查詢時發生。

(繼承來源 QueryableDataSource)
Selected

在資料擷取作業完成時發生。

Selecting

在資料擷取作業之前發生。

Unload

發生於伺服器控制項從記憶體卸載時。

(繼承來源 Control)
Updated

在更新作業完成時發生。

Updating

在更新作業之前發生。

明確介面實作

IControlBuilderAccessor.ControlBuilder

如需這個成員的說明,請參閱 ControlBuilder

(繼承來源 Control)
IControlDesignerAccessor.GetDesignModeState()

如需這個成員的說明,請參閱 GetDesignModeState()

(繼承來源 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

如需這個成員的說明,請參閱 SetDesignModeState(IDictionary)

(繼承來源 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

如需這個成員的說明,請參閱 SetOwnerControl(Control)

(繼承來源 Control)
IControlDesignerAccessor.UserData

如需這個成員的說明,請參閱 UserData

(繼承來源 Control)
IDataBindingsAccessor.DataBindings

如需這個成員的說明,請參閱 DataBindings

(繼承來源 Control)
IDataBindingsAccessor.HasDataBindings

如需這個成員的說明,請參閱 HasDataBindings

(繼承來源 Control)
IDataSource.DataSourceChanged

當資料來源控制項變更的方式會影響資料繫結控制項時發生。

(繼承來源 DataSourceControl)
IDataSource.GetView(String)

取得與 DataSourceView 控制項關聯的具名 DataSourceControl 物件。 有些資料來源控制項只支援一個檢視,有些則可支援多個檢視。

(繼承來源 DataSourceControl)
IDataSource.GetViewNames()

取得名稱集合,表示與 DataSourceView 控制項關聯的 DataSourceControl 物件清單。

(繼承來源 DataSourceControl)
IDynamicDataSource.ContextType

如需這個成員的說明,請參閱 IDynamicDataSource

IDynamicDataSource.EntitySetName

如需這個成員的說明,請參閱 IDynamicDataSource

IDynamicDataSource.Exception

如需這個成員的說明,請參閱 IDynamicDataSource

IExpressionsAccessor.Expressions

如需這個成員的說明,請參閱 Expressions

(繼承來源 Control)
IExpressionsAccessor.HasExpressions

如需這個成員的說明,請參閱 HasExpressions

(繼承來源 Control)
IListSource.ContainsListCollection

指示資料來源控制項是否與一個或多個資料清單產生關聯。

(繼承來源 DataSourceControl)
IListSource.GetList()

取得可以當做資料清單來源使用的資料來源控制項清單。

(繼承來源 DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

如需這個成員的說明,請參閱 AddParsedSubObject(Object)

(繼承來源 Control)

擴充方法

ExpandDynamicWhereParameters(IDynamicDataSource)

將動態篩選條件擴大成資料來源可用的 Where 參數。

FindDataSourceControl(Control)

傳回與指定之控制項的資料控制項相關聯的資料來源。

FindFieldTemplate(Control, String)

傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。

FindMetaTable(Control)

傳回包含資料控制項的中繼資料表物件。

GetDefaultValues(IDataSource)

取得所指定資料來源的預設值集合。

GetMetaTable(IDataSource)

取得所指定資料來源物件中的資料表中繼資料。

GetTable(IDynamicDataSource)

傳回與指定之資料來源控制項相關聯的 MetaTable 物件。

LoadWith<TEntity>(LinqDataSource)

設定 LINQ-to-SQL 的 DataLoadOptions 值,以強制載入所有外部索引鍵實體 (Entity)。

LoadWithForeignKeys(LinqDataSource, Type)

設定 LINQ-to-SQL 的 DataLoadOptions 值,以強制載入所有外部索引鍵實體 (Entity)。

TryGetMetaTable(IDataSource, MetaTable)

判斷資料表中繼資料是否可供使用。

適用於

另請參閱