GridView GridView GridView GridView Class

定義

在資料表中顯示資料來源的值,其中每個資料行表示一個欄位,每個資料列表示一個資料錄。Displays the values of a data source in a table where each column represents a field and each row represents a record. 您可以利用 GridView 控制項選取、排序及編輯這些項目。The GridView control enables you to select, sort, and edit these items.

public ref class GridView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataKeysControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IDataBoundListControl, System::Web::UI::WebControls::IFieldControl, System::Web::UI::WebControls::IPersistedSelector, System::Web::UI::WebControls::IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class GridView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataKeysControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPersistedSelector, System.Web.UI.WebControls.IPostBackContainer
type GridView = class
    inherit CompositeDataBoundControl
    interface IPostBackContainer
    interface IPostBackEventHandler
    interface ICallbackContainer
    interface ICallbackEventHandler
    interface IPersistedSelector
    interface IDataKeysControl
    interface IDataBoundListControl
    interface IDataBoundControl
    interface IFieldControl
Public Class GridView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataBoundListControl, IDataKeysControl, IFieldControl, IPersistedSelector, IPostBackContainer, IPostBackEventHandler
繼承
屬性
實作

範例

含有原始程式碼的 Visual Studio Web site 專案位於本主題隨附了:下載A Visual Studio Web site project with source code is available to accompany this topic: Download.

下列範例示範如何使用GridView控制項來顯示 Microsoft SQL Server 中的 AdventureWorksLT 範例資料庫的 Customers 資料表中的值。The following example demonstrates how use the GridView control to display the values from the Customers table of the AdventureWorksLT sample database in Microsoft SQL Server. 使用擷取的值SqlDataSource控制項。The values are retrieved using a SqlDataSource control.

<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>
<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>

下列範例示範如何使用GridView控制項和LinqDataSource控制項,讓您可以編輯記錄。The following example demonstrates how to use the GridView control and a LinqDataSource control so that you can edit records.

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>
<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

如需示範如何存取中的資料格的值的範例,請參閱GridViewRowFor an example demonstrating how to access values in cells, see GridViewRow.

備註

本主題內容:In this topic:

簡介Introduction

GridView控制項來顯示資料表中的資料來源的值。The GridView control is used to display the values of a data source in a table. 每個資料行來表示欄位,而每個資料列代表一筆記錄。Each column represents a field, while each row represents a record. GridView控制項支援下列功能:The GridView control supports the following features:

  • 繫結至資料來源控制項,例如SqlDataSourceBinding to data source controls, such as SqlDataSource.

  • 內建排序功能。Built-in sort capabilities.

  • 內建更新和刪除功能。Built-in update and delete capabilities.

  • 內建的分頁功能。Built-in paging capabilities.

  • 內建的資料列選取範圍的功能。Built-in row selection capabilities.

  • 以程式設計方式存取GridView物件模型,以動態方式設定屬性,處理事件,然後依此類推。Programmatic access to the GridView object model to dynamically set properties, handle events, and so on.

  • 多個索引鍵的欄位。Multiple key fields.

  • 超連結資料行的多個資料欄位。Multiple data fields for the hyperlink columns.

  • 自訂佈景主題和樣式的外觀。Customizable appearance through themes and styles.

  • 若要深入了解可在 ASP.NET 中的其他資料繫結控制項,請參閱繫結資料的 Web 伺服器控制項To learn about the other data-bound controls that are available in ASP.NET, see Data-Bound Web Server Controls.

注意

如果您熟悉DataGrid從.NET Framework 1.0 版中,控制項GridView控制項是後續DataGrid控制項。If you are familiar with the DataGrid control from the .NET Framework version 1.0, the GridView control is the successor to the DataGrid control.

資料行欄位Column Fields

在每個資料行GridView控制項由DataControlField物件。Each column in the GridView control is represented by a DataControlField object. 根據預設,AutoGenerateColumns屬性設定為true,這會建立AutoGeneratedField資料來源中每個欄位的物件。By default, the AutoGenerateColumns property is set to true, which creates an AutoGeneratedField object for each field in the data source. 每個欄位則會轉譯為中的資料行GridView順序的每個欄位會出現在資料來源控制項。Each field is then rendered as a column in the GridView control in the order that each field appears in the data source.

您可以手動控制欄位會出現在哪個資料行GridView控制項,藉由設定AutoGenerateColumns屬性設false然後定義您自己的資料行欄位集合。You can also manually control which column fields appear in the GridView control by setting the AutoGenerateColumns property to false and then defining your own column field collection. 不同的資料行的欄位類型決定在控制項中的資料行的行為。Different column field types determine the behavior of the columns in the control. 下表列出可用的不同的資料行欄位型別。The following table lists the different column field types that can be used.

資料行欄位類型Column field type 描述Description
BoundField 資料來源中顯示欄位的值。Displays the value of a field in a data source. 這是預設的資料行類型GridView控制項。This is the default column type of the GridView control.
ButtonField 顯示每個項目中的命令按鈕GridView控制項。Displays a command button for each item in the GridView control. 這可讓您建立的自訂按鈕控制項,例如 [新增] 或 [移除] 按鈕的資料行。This enables you to create a column of custom button controls, such as the Add or the Remove button.
CheckBoxField 顯示每個項目中的核取方塊GridView控制項。Displays a check box for each item in the GridView control. 這個資料行的欄位型別通常用於顯示的布林值的欄位。This column field type is commonly used to display fields with a Boolean value.
CommandField 顯示預先定義的命令按鈕,來執行選取、 編輯或刪除作業。Displays predefined command buttons to perform select, edit, or delete operations.
HyperLinkField 資料來源中的欄位的值顯示為超連結。Displays the value of a field in a data source as a hyperlink. 這個資料行的欄位型別可讓您的第二個欄位繫結至超連結的 URL。This column field type enables you to bind a second field to the hyperlink's URL.
ImageField 顯示每個項目中的映像GridView控制項。Displays an image for each item in the GridView control.
TemplateField 顯示使用者定義的內容中的每個項目的GridView根據指定的範本的控制項。Displays user-defined content for each item in the GridView control according to a specified template. 這個資料行的欄位型別可讓您建立自訂的資料行欄位。This column field type enables you to create a custom column field.

若要以宣告方式定義資料行欄位集合,請先將左右<Columns>標記的開頭和結尾標記之間GridView控制項。To define a column field collection declaratively, first add opening and closing <Columns> tags between the opening and closing tags of the GridView control. 接下來,列出您想要包含的開頭和結尾之間的資料行欄位<Columns>標記。Next, list the column fields that you want to include between the opening and closing <Columns> tags. 指定的資料行加入Columns集合的順序列出。The columns specified are added to the Columns collection in the order listed. Columns集合會儲存所有資料行欄位控制項中,而且可讓您以程式設計方式管理中的資料行欄位GridView控制項。The Columns collection stores all the column fields in the control and enables you to programmatically manage the column fields in the GridView control.

明確宣告的資料行欄位可以顯示在具有自動產生的資料行欄位的組合。Explicitly declared column fields can be displayed in combination with automatically generated column fields. 同時使用時,明確宣告的資料行欄位會呈現第一次後, 接的自動產生的資料行欄位。When both are used, explicitly declared column fields are rendered first, followed by the automatically generated column fields.

注意

自動產生的資料行欄位不會新增至Columns集合。Automatically generated column fields are not added to the Columns collection.

繫結至資料Binding to Data

GridView控制項可以繫結至資料來源控制項 (例如SqlDataSource控制或ObjectDataSource控制項) 或會實作任何資料來源收集System.Collections.IEnumerable介面,例如System.Data.DataViewSystem.Collections.ArrayListSystem.Collections.Generic.List<T>,或其他集合型別。The GridView control can be bound to a data source control (such as the SqlDataSource control or ObjectDataSource control) or to any data source collection that implements the System.Collections.IEnumerable interface, such as System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, or other collection types. 使用下列方法的其中一個繫結GridView控制項以適當的資料來源類型:Use one of the following methods to bind the GridView control to the appropriate data source type:

  • 若要繫結至資料來源控制項,將DataSourceID屬性GridView若要控制ID資料來源控制項的值。To bind to a data source control, set the DataSourceID property of the GridView control to the ID value of the data source control. GridView控制項自動繫結至指定的資料來源控制項,並可以讓您利用資料來源的控制項的功能來執行排序、 更新、 刪除和分頁。The GridView control automatically binds to the specified data source control and can take advantage of the data source control's capabilities to perform sorting, updating, deleting, and paging. 這是要繫結至資料的慣用的方法。This is the preferred method to bind to data.

  • 繫結至資料來源會實作System.Collections.IEnumerable介面,以程式設計方式設定DataSource屬性GridView控制項至資料來源,並接著呼叫DataBind方法。To bind to a data source that implements the System.Collections.IEnumerable interface, programmatically set the DataSource property of the GridView control to the data source and then call the DataBind method. 當使用這個方法,GridView控制項不會提供內建排序、 update、 delete 和分頁功能。When using this method, the GridView control does not provide built-in sort, update, delete, and paging functionality. 您需要使用適當的事件提供這項功能。You need to provide this functionality by using the appropriate event.

如需有關資料繫結的詳細資訊,請參閱 < ASP.NET 資料存取內容對應For more information about data binding, see ASP.NET Data Access Content Map.

注意

此控制項可用來顯示使用者輸入,其中可能包含惡意的用戶端指令碼。This control can be used to display user input, which might include malicious client script. 檢查從用戶端可執行的指令碼、 SQL 陳述式,或其他程式碼傳送之前顯示在您的應用程式中的任何資訊。Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. 可能的話,強烈建議的值進行 HTML 編碼此控制項中顯示之前 (BoundField類別預設的 HTML 編碼的值)。Whenever possible, it is strongly recommended that values are HTML-encoded before they are displayed in this control (the BoundField class HTML-encodes values by default). ASP.NET 提供使用者輸入來封鎖指令碼和 HTML 的輸入的要求驗證功能。ASP.NET provides an input request validation feature to block script and HTML in user input. 驗證伺服器控制項也會提供以評估使用者輸入。Validation server controls are also provided to assess user input. 如需詳細資訊,請參閱 < 驗證控制項簡介For more information, see Introduction to the Validation Controls.

資料作業Data Operations

GridView控制項提供許多內建功能,可讓使用者排序、 更新、 刪除、 選取和逐頁瀏覽控制項中的項目。The GridView control provides many built-in capabilities that allow the user to sort, update, delete, select, and page through items in the control. GridView控制項繫結至資料來源控制項,GridView控制項可以利用資料來源控制項的功能,並提供自動排序、 更新和刪除功能。When the GridView control is bound to a data source control, the GridView control can take advantage of the data source control's capabilities and provide automatic sort, update, and delete functionality.

注意

GridView控制項可以提供排序、 更新和刪除與其他類型的資料來源的支援。The GridView control can provide support for sorting, updating, and deleting with other types of data sources. 不過,您必須提供這些作業的實作中的適當事件處理常式。However, you will need to provide an appropriate event handler with the implementation for these operations.

排序功能可以讓使用者排序中的項目GridView相對於特定的資料行,按一下資料行行首的控制項。Sorting allows the user to sort the items in the GridView control with respect to a specific column by clicking on the column's header. 若要啟用排序,請設定AllowSorting屬性設trueTo enable sorting, set the AllowSorting property to true.

中的按鈕時,會啟用自動更新、 刪除和選取項目功能ButtonFieldTemplateField分別按一下資料行 欄位中的,使用 編輯、 刪除 和 選取,命令名稱。The automatic updating, deleting, and selection functionalities are enabled when a button in a ButtonField or TemplateField column field, with a command name of "Edit", "Delete", and "Select", respectively, is clicked. GridView控制項可以自動新增CommandField資料行欄位使用的編輯、 刪除或選取 按鈕,如果AutoGenerateEditButtonAutoGenerateDeleteButton,或AutoGenerateSelectButton屬性設定為true分別。The GridView control can automatically add a CommandField column field with an Edit, Delete, or Select button if the AutoGenerateEditButton, AutoGenerateDeleteButton, or AutoGenerateSelectButton property is set to true, respectively.

注意

將記錄插入至資料來源不直接支援GridView控制項。Inserting records into the data source is not directly supported by the GridView control. 不過,就可以使用插入資料錄GridView控制項搭配DetailsViewFormView控制項。However, it is possible to insert records by using the GridView control in conjunction with the DetailsView or FormView control. 如需詳細資訊,請參閱 < DetailsViewFormView分別。For more information, see DetailsView or FormView, respectively.

而不是顯示資料來源中的所有記錄,在此同時,GridView控制項可以自動分成記錄頁面。Instead of displaying all the records in the data source at the same time, the GridView control can automatically break the records up into pages. 若要啟用分頁,將AllowPaging屬性設trueTo enable paging, set the AllowPaging property to true.

注意

GridView控制項是重新建立在儲存中的資訊為基礎的回傳ViewStateThe GridView control is re-created on postback based on the information that is stored in ViewState. 如果GridView控制項包含TemplateFieldCommandField具有CausesValidation屬性設定為true,則EnableViewState屬性也必須設為true確保並行資料作業,例如更新和刪除,則會套用至適當的資料列。If the GridView control includes a TemplateField or a CommandField with the CausesValidation property set to true, then the EnableViewState property must also be set to true to ensure that concurrent data operations, such as updates and deletes, apply to the appropriate row.

自訂使用者介面Customizing the User Interface

您可以自訂的外觀GridView藉由設定不同的組件控制項的樣式屬性的控制項。You can customize the appearance of the GridView control by setting the style properties for the different parts of the control. 下表列出不同的樣式屬性。The following table lists the different style properties.

樣式屬性Style property 描述Description
AlternatingRowStyle 替代資料列中的樣式設定GridView控制項。The style settings for the alternating data rows in the GridView control. 當設定這個屬性時,資料列會顯示交替RowStyle設定和AlternatingRowStyle設定。When this property is set, the data rows are displayed alternating between the RowStyle settings and the AlternatingRowStyle settings.
EditRowStyle 正在編輯中的資料列的樣式設定GridView控制項。The style settings for the row being edited in the GridView control.
EmptyDataRowStyle 空白資料列中顯示的樣式設定GridView控制當資料來源不包含任何記錄。The style settings for the empty data row displayed in the GridView control when the data source does not contain any records.
FooterStyle 頁尾資料列的樣式設定GridView控制項。The style settings for the footer row of the GridView control.
HeaderStyle 標頭資料列的樣式設定GridView控制項。The style settings for the header row of the GridView control.
PagerStyle 頁面巡覽列的樣式設定GridView控制項。The style settings for the pager row of the GridView control.
RowStyle 中的資料列的樣式設定GridView控制項。The style settings for the data rows in the GridView control. AlternatingRowStyle也會設定屬性,則資料列會顯示交替RowStyle設定和AlternatingRowStyle設定。When the AlternatingRowStyle property is also set, the data rows are displayed alternating between the RowStyle settings and the AlternatingRowStyle settings.
SelectedRowStyle 在 選取的資料列的樣式設定GridView控制項。The style settings for the selected row in the GridView control.
SortedAscendingCellStyle 樣式設定的資料行的資料會依照在GridView控制項。The style setting for the data column the data is sorted by in the GridView control. 設定此樣式時,樣式 (例如,反白顯示資料行) 會套用到資料格,以遞增順序排序資料時。When this style is set, the style (for example, highlighted column) is applied to cells when the data is sorted in ascending order.
SortedAscendingHeaderStyle 樣式設定的資料行的資料會依照在GridView控制項。The style setting for the data column the data is sorted by in the GridView control. 設定此樣式時,將箭號表示遞增排序的資料放在標頭GridView控制當資料以遞增順序排序。When this style is set, an arrow indicating the data is sorted ascending is placed on the header of the GridView control when the data is sorted in ascending order.
SortedDescendingCellStyle 樣式設定的資料行的資料會依照在GridView控制項。The style setting for the data column the data is sorted by in the GridView control. 設定此樣式時,樣式 (例如,反白顯示資料行) 會套用到資料格,以遞減順序排序資料時。When this style is set, the style (for example, highlighted column) is applied to cells when the data is sorted in descending order.
SortedDescendingHeaderStyle 樣式設定的資料行的資料會依照在GridView控制項。The style setting for the data column the data is sorted by in the GridView control. 當設定這個樣式時,箭號指向相應減少所在的標頭GridView當資料以遞減順序排序。When this style is set, an arrow pointing down is placed on the header of the GridView when the data is sorted in descending order.

您也可以顯示或隱藏控制項的不同部分。You can also show or hide different parts of the control. 下表列出可控制哪些部分會顯示或隱藏屬性。The following table lists the properties that control which parts are shown or hidden.

屬性Property 描述Description
ShowFooter 顯示或隱藏頁尾區段的GridView控制項。Shows or hides the footer section of the GridView control.
ShowHeader 顯示或隱藏的標頭區段GridView控制項。Shows or hides the header section of the GridView control.

事件Events

GridView控制項提供數個事件,您可以進行程式設計。The GridView control provides several events that you can program against. 這可讓您執行自訂的常式,每當事件發生時。This enables you to run a custom routine whenever an event occurs. 下表列出支援的事件GridView控制項。The following table lists the events that are supported by the GridView control.

Event - 事件Event 描述Description
PageIndexChanged 按一下其中一個頁面巡覽區按鈕時發生 (但在 GridView 控制項處理分頁作業之後)。Occurs when one of the pager buttons is clicked, but after the GridView control handles the paging operation. 當您需要執行的工作之後使用者瀏覽到控制項中的不同頁面, 時,通常使用這個事件。This event is commonly used when you need to perform a task after the user navigates to a different page in the control.
PageIndexChanging 發生於按一下其中一個頁面巡覽區按鈕時,但是在 GridView 控制項處理分頁作業之前。Occurs when one of the pager buttons is clicked, but before the GridView control handles the paging operation. 此事件通常用來取消分頁作業。This event is often used to cancel the paging operation.
RowCancelingEdit 發生於按一下的資料列的 [取消] 按鈕,但尚未GridView控制離開編輯模式。Occurs when a row's Cancel button is clicked, but before the GridView control exits edit mode. 若要停止取消的作業通常使用這個事件。This event is often used to stop the canceling operation.
RowCommand 按一下 GridView 控制項中的按鈕時會發生這個事件。Occurs when a button is clicked in the GridView control. 若要在控制項中按一下按鈕時執行的工作通常使用這個事件。This event is often used to perform a task when a button is clicked in the control.
RowCreated 中建立新的資料列時,就會發生GridView控制項。Occurs when a new row is created in the GridView control. 若要修改的資料列的內容,建立資料列時,通常使用這個事件。This event is often used to modify the contents of a row when the row is created.
RowDataBound 資料列中的資料繫結時,就會發生GridView控制項。Occurs when a data row is bound to data in the GridView control. 這個事件通常用於資料列繫結至資料修改的資料列的內容。This event is often used to modify the contents of a row when the row is bound to data.
RowDeleted 發生於按一下的資料列的 [刪除] 按鈕,但之後GridView控制從資料來源中刪除記錄。Occurs when a row's Delete button is clicked, but after the GridView control deletes the record from the data source. 此事件通常用來檢查刪除作業的結果。This event is often used to check the results of the delete operation.
RowDeleting 發生於按一下的資料列的 [刪除] 按鈕,但尚未GridView控制從資料來源中刪除記錄。Occurs when a row's Delete button is clicked, but before the GridView control deletes the record from the data source. 此事件通常用來取消刪除作業。This event is often used to cancel the deleting operation.
RowEditing 按一下資料列的 [編輯] 按鈕時發生 (但在 GridView 控制項進入編輯模式之前)。Occurs when a row's Edit button is clicked, but before the GridView control enters edit mode. 此事件通常用來取消編輯作業。This event is often used to cancel the editing operation.
RowUpdated 按一下資料列的 [更新] 按鈕時發生 (但在 GridView 控制項更新資料列之後)。Occurs when a row's Update button is clicked, but after the GridView control updates the row. 此事件通常會用來檢查更新作業的結果中。This event is often used to check the results of the update operation.
RowUpdating 按一下資料列的 [更新] 按鈕時發生 (但在 GridView 控制項更新資料列之前)。Occurs when a row's Update button is clicked, but before the GridView control updates the row. 此事件通常用來取消更新作業。This event is often used to cancel the updating operation.
SelectedIndexChanged 按一下資料列的 [選取] 按鈕時發生 (但在 GridView 控制項處理選取作業之後)。Occurs when a row's Select button is clicked, but after the GridView control handles the select operation. 這個事件通常用於執行工作,在控制項中選取一個資料列之後。This event is often used to perform a task after a row is selected in the control.
SelectedIndexChanging 按一下資料列的 [選取] 按鈕時發生 (但在 GridView 控制項處理選取作業之前)。Occurs when a row's Select button is clicked, but before the GridView control handles the select operation. 若要取消了選取作業通常使用這個事件。This event is often used to cancel the selection operation.
Sorted 按一下排序資料行的超連結時發生 (但在 GridView 控制項處理排序作業之後)。Occurs when the hyperlink to sort a column is clicked, but after the GridView control handles the sort operation. 這個事件通常用於執行工作,在使用者按一下排序資料行的超連結之後。This event is commonly used to perform a task after the user clicks a hyperlink to sort a column.
Sorting 按一下排序資料行的超連結時發生 (但在 GridView 控制項處理排序作業之前)。Occurs when the hyperlink to sort a column is clicked, but before the GridView control handles the sort operation. 通常在取消排序作業,或執行自訂排序常式,會使用這個事件。This event is often used to cancel the sorting operation or to perform a custom sorting routine.

協助工具選項Accessibility

如需如何設定這個控制項,使其產生符合協助工具標準的標記資訊,請參閱協助工具的 Visual Studio 及 ASP.NETASP.NET 控制項和協助工具.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

宣告式語法Declarative Syntax

<asp:GridView  
    AccessKey="string"  
    AllowPaging="True|False"  
    AllowSorting="True|False"  
    AutoGenerateColumns="True|False"  
    AutoGenerateDeleteButton="True|False"  
    AutoGenerateEditButton="True|False"  
    AutoGenerateSelectButton="True|False"  
    BackColor="color name|#dddddd"  
    BackImageUrl="uri"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    Caption="string"  
    CaptionAlign="NotSet|Top|Bottom|Left|Right"  
    CellPadding="integer"  
    CellSpacing="integer"  
    CssClass="string"  
    DataKeyNames="string"  
    DataMember="string"  
    DataSource="string"  
    DataSourceID="string"  
    EditIndex="integer"  
    EmptyDataText="string"  
    Enabled="True|False"  
    EnableSortingAndPagingCallbacks="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
        Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    GridLines="None|Horizontal|Vertical|Both"  
    Height="size"  
    HorizontalAlign="NotSet|Left|Center|Right|Justify"  
    ID="string"  
    OnDataBinding="DataBinding event handler"  
    OnDataBound="DataBound event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPageIndexChanged="PageIndexChanged event handler"  
    OnPageIndexChanging="PageIndexChanging event handler"  
    OnPreRender="PreRender event handler"  
    OnRowCancelingEdit="RowCancelingEdit event handler"  
    OnRowCommand="RowCommand event handler"  
    OnRowCreated="RowCreated event handler"  
    OnRowDataBound="RowDataBound event handler"  
    OnRowDeleted="RowDeleted event handler"  
    OnRowDeleting="RowDeleting event handler"  
    OnRowEditing="RowEditing event handler"  
    OnRowUpdated="RowUpdated event handler"  
    OnRowUpdating="RowUpdating event handler"  
    OnSelectedIndexChanged="SelectedIndexChanged event handler"  
    OnSelectedIndexChanging="SelectedIndexChanging event handler"  
    OnSorted="Sorted event handler"  
    OnSorting="Sorting event handler"  
    OnUnload="Unload event handler"  
    PageIndex="integer"  
    PagerSettings-FirstPageImageUrl="uri"  
    PagerSettings-FirstPageText="string"  
    PagerSettings-LastPageImageUrl="uri"  
    PagerSettings-LastPageText="string"  
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|  
        NumericFirstLast"  
    PagerSettings-NextPageImageUrl="uri"  
    PagerSettings-NextPageText="string"  
    PagerSettings-PageButtonCount="integer"  
    PagerSettings-Position="Bottom|Top|TopAndBottom"  
    PagerSettings-PreviousPageImageUrl="uri"  
    PagerSettings-PreviousPageText="string"  
    PagerSettings-Visible="True|False"  
    PageSize="integer"  
    RowHeaderColumn="string"  
    runat="server"  
    SelectedIndex="integer"  
    ShowFooter="True|False"  
    ShowHeader="True|False"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    ToolTip="string"  
    UseAccessibleHeader="True|False"  
    Visible="True|False"  
    Width="size"  
>  
        <AlternatingRowStyle />  
        <Columns>  
                <asp:BoundField  
                    AccessibleHeaderText="string"  
                    ApplyFormatInEditMode="True|False"  
                    ConvertEmptyStringToNull="True|False"  
                    DataField="string"  
                    DataFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    HtmlEncode="True|False"  
                    InsertVisible="True|False"  
                    NullDisplayText="string"  
                    ReadOnly="True|False"  
                    ShowHeader="True|False"  
                    SortExpression="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:BoundField>  
                <asp:ButtonField  
                    AccessibleHeaderText="string"  
                    ButtonType="Button|Image|Link"  
                    CausesValidation="True|False"  
                    CommandName="string"  
                    DataTextField="string"  
                    DataTextFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    ImageUrl="uri"  
                    InsertVisible="True|False"  
                    ShowHeader="True|False"  
                    SortExpression="string"  
                    Text="string"  
                    ValidationGroup="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:ButtonField>  
                <asp:CheckBoxField  
                    AccessibleHeaderText="string"  
                    DataField="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    InsertVisible="True|False"  
                    ReadOnly="True|False"  
                    ShowHeader="True|False"  
                    SortExpression="string"  
                    Text="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:CheckBoxField>  
                <asp:CommandField  
                    AccessibleHeaderText="string"  
                    ButtonType="Button|Image|Link"  
                    CancelImageUrl="uri"  
                    CancelText="string"  
                    CausesValidation="True|False"  
                    DeleteImageUrl="uri"  
                    DeleteText="string"  
                    EditImageUrl="uri"  
                    EditText="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    InsertImageUrl="uri"  
                    InsertText="string"  
                    InsertVisible="True|False"  
                    NewImageUrl="uri"  
                    NewText="string"  
                    SelectImageUrl="uri"  
                    SelectText="string"  
                    ShowCancelButton="True|False"  
                    ShowDeleteButton="True|False"  
                    ShowEditButton="True|False"  
                    ShowHeader="True|False"  
                    ShowInsertButton="True|False"  
                    ShowSelectButton="True|False"  
                    SortExpression="string"  
                    UpdateImageUrl="uri"  
                    UpdateText="string"  
                    ValidationGroup="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:CommandField>  
                <asp:DynamicField  
                    AccessibleHeaderText="string"  
                    ApplyFormatInEditMode="True|False"  
                    ConvertEmptyStringToNull="True|False"  
                    DataField="string"  
                    DataFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    HtmlEncode="True|False"  
                    InsertVisible="True|False"  
                    NullDisplayText="string"  
                    ShowHeader="True|False"  
                    UIHint="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:DynamicField>  
                <asp:HyperLinkField  
                    AccessibleHeaderText="string"  
                    DataNavigateUrlFields="string"  
                    DataNavigateUrlFormatString="string"  
                    DataTextField="string"  
                    DataTextFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    InsertVisible="True|False"  
                    NavigateUrl="uri"  
                    ShowHeader="True|False"  
                    SortExpression="string"  
                    Target="string|_blank|_parent|_search|_self|_top"  
                    Text="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:HyperLinkField>  
                <asp:ImageField  
                    AccessibleHeaderText="string"  
                    AlternateText="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DataAlternateTextField="string"  
                    DataAlternateTextFormatString="string"  
                    DataImageUrlField="string"  
                    DataImageUrlFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    InsertVisible="True|False"  
                    NullDisplayText="string"  
                    NullImageUrl="uri"  
                    ReadOnly="True|False"  
                    ShowHeader="True|False"  
                    SortExpression="string"  
                    Visible="True|False"  
>  
                        <ControlStyle />  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:ImageField>  
                <asp:TemplateField  
                    AccessibleHeaderText="string"  
                    ConvertEmptyStringToNull="True|False"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    InsertVisible="True|False"  
                    ShowHeader="True|False"  
                    SortExpression="string"  
                    Visible="True|False"  
>  
                            <ControlStyle />  
                            <FooterStyle />  
                            <HeaderStyle />  
                            <ItemStyle />  
                        <AlternatingItemTemplate>  
                            <!-- child controls -->  
                        </AlternatingItemTemplate>  
                        <EditItemTemplate>  
                            <!-- child controls -->  
                        </EditItemTemplate>  
                        <FooterTemplate>  
                            <!-- child controls -->  
                        </FooterTemplate>  
                        <HeaderTemplate>  
                            <!-- child controls -->  
                        </HeaderTemplate>  
                        <InsertItemTemplate>  
                            <!-- child controls -->  
                        </InsertItemTemplate>  
                        <ItemTemplate>  
                            <!-- child controls -->  
                        </ItemTemplate>  
                </asp:TemplateField>  
        </Columns>  
        <EditRowStyle />  
        <EmptyDataRowStyle />  
        <EmptyDataTemplate>  
            <!-- child controls -->  
        </EmptyDataTemplate>  
        <FooterStyle />  
        <HeaderStyle />  
        <PagerSettings  
            FirstPageImageUrl="uri"  
            FirstPageText="string"  
            LastPageImageUrl="uri"  
            LastPageText="string"  
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|  
                NumericFirstLast"  
            NextPageImageUrl="uri"  
            NextPageText="string"  
            OnPropertyChanged="PropertyChanged event handler"  
            PageButtonCount="integer"  
            Position="Bottom|Top|TopAndBottom"  
            PreviousPageImageUrl="uri"  
            PreviousPageText="string"  
            Visible="True|False"  
        />  
        <PagerStyle />  
        <PagerTemplate>  
            <!-- child controls -->  
        </PagerTemplate>  
        <RowStyle />  
        <SelectedRowStyle />  
</asp:GridView>  

建構函式

GridView() GridView() GridView() GridView()

初始化 GridView 類別的新執行個體。Initializes a new instance of the GridView class.

屬性

AccessKey AccessKey AccessKey AccessKey

取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Inherited from WebControl)
Adapter Adapter Adapter Adapter

針對控制項取得瀏覽器的特定配置器。Gets the browser-specific adapter for the control.

(Inherited from Control)
AllowCustomPaging AllowCustomPaging AllowCustomPaging AllowCustomPaging

取得或設定值,指出是否啟用自訂分頁。Gets or sets a value that indicates whether custom paging is enabled.

AllowPaging AllowPaging AllowPaging AllowPaging

取得或設定值,指出是否啟用分頁功能。Gets or sets a value indicating whether the paging feature is enabled.

AllowSorting AllowSorting AllowSorting AllowSorting

取得或設定值,指出是否啟用排序功能。Gets or sets a value indicating whether the sorting feature is enabled.

AlternatingRowStyle AlternatingRowStyle AlternatingRowStyle AlternatingRowStyle

取得 TableItemStyle 物件的參考,可讓您設定 GridView 控制項中替代資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of alternating data rows in a GridView control.

AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

取得或設定包含了此控制項之 PageUserControl 物件的相對應用程式虛擬目錄。Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
Attributes Attributes Attributes Attributes

取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Inherited from WebControl)
AutoGenerateColumns AutoGenerateColumns AutoGenerateColumns AutoGenerateColumns

取得或設定值,指出是否自動建立資料來源中每個欄位的繫結欄位。Gets or sets a value indicating whether bound fields are automatically created for each field in the data source.

AutoGenerateDeleteButton AutoGenerateDeleteButton AutoGenerateDeleteButton AutoGenerateDeleteButton

取得或設定值,指出是否會將具有每個資料列之 [刪除] 按鈕的 CommandField 欄位資料行自動加入至 GridView 控制項。Gets or sets a value indicating whether a CommandField field column with a Delete button for each data row is automatically added to a GridView control.

AutoGenerateEditButton AutoGenerateEditButton AutoGenerateEditButton AutoGenerateEditButton

取得或設定值,指出是否會將具有每個資料列之 [編輯] 按鈕的 CommandField 欄位資料行自動加入至 GridView 控制項。Gets or sets a value indicating whether a CommandField field column with an Edit button for each data row is automatically added to a GridView control.

AutoGenerateSelectButton AutoGenerateSelectButton AutoGenerateSelectButton AutoGenerateSelectButton

取得或設定值,指出是否會將具有每個資料列之 [選取] 按鈕的 CommandField 欄位資料行自動加入至 GridView 控制項。Gets or sets a value indicating whether a CommandField field column with a Select button for each data row is automatically added to a GridView control.

BackColor BackColor BackColor BackColor

取得或設定 Web 伺服器控制項的背景色彩。Gets or sets the background color of the Web server control.

(Inherited from WebControl)
BackImageUrl BackImageUrl BackImageUrl BackImageUrl

取得或設定要顯示於 GridView 控制項背景之影像的 URL。Gets or sets the URL to an image to display in the background of a GridView control.

BindingContainer BindingContainer BindingContainer BindingContainer

取得包含了此控制項之資料繫結的控制項。Gets the control that contains this control's data binding.

(Inherited from Control)
BorderColor BorderColor BorderColor BorderColor

取得或設定 Web 控制項的框線色彩。Gets or sets the border color of the Web control.

(Inherited from WebControl)
BorderStyle BorderStyle BorderStyle BorderStyle

取得或設定 Web 伺服器控制項的框線樣式。Gets or sets the border style of the Web server control.

(Inherited from WebControl)
BorderWidth BorderWidth BorderWidth BorderWidth

取得或設定 Web 伺服器控制項的框線寬度。Gets or sets the border width of the Web server control.

(Inherited from WebControl)
BottomPagerRow BottomPagerRow BottomPagerRow BottomPagerRow

取得 GridViewRow 物件,其表示 GridView 控制項中的底端頁面巡覽列。Gets a GridViewRow object that represents the bottom pager row in a GridView control.

Caption Caption Caption Caption

取得或設定要在 GridView 控制項之 HTML 標題項目中呈現的文字。Gets or sets the text to render in an HTML caption element in a GridView control. 這個屬性可讓協助技術裝置的使用者更容易存取控制項。This property is provided to make the control more accessible to users of assistive technology devices.

CaptionAlign CaptionAlign CaptionAlign CaptionAlign

取得或設定 GridView 控制項中 HTML 標題項目的水平或垂直位置。Gets or sets the horizontal or vertical position of the HTML caption element in a GridView control. 這個屬性可讓協助技術裝置的使用者更容易存取控制項。This property is provided to make the control more accessible to users of assistive technology devices.

CellPadding CellPadding CellPadding CellPadding

取得或設定儲存格內容和其框線之間的間距。Gets or sets the amount of space between the contents of a cell and the cell's border.

CellSpacing CellSpacing CellSpacing CellSpacing

取得或設定儲存格之間的間距。Gets or sets the amount of space between cells.

ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

取得值,指出是否已經建立伺服器控制項的子控制項。Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

取得或設定用來產生 ClientID 屬性值的演算法。Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDRowSuffix ClientIDRowSuffix ClientIDRowSuffix ClientIDRowSuffix

取得或設定資料欄位的名稱,這些值會附加至 ClientID 屬性,以便識別資料繫結控制項的每一個唯一的執行個體。Gets or sets the names of the data fields whose values are appended to the ClientID property value to uniquely identify each instance of a data-bound control.

ClientIDRowSuffixDataKeys ClientIDRowSuffixDataKeys ClientIDRowSuffixDataKeys ClientIDRowSuffixDataKeys

取得資料值,這些值會在 ASP.NET 產生 ClientID 值時,用來識別資料繫結控制項的每個唯一的執行個體。Gets the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.

ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

取得字元值,表示在 ClientID 屬性中所使用的分隔字元。Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Columns Columns Columns Columns

取得 DataControlField 物件的集合,其表示 GridView 控制項中的資料行欄位。Gets a collection of DataControlField objects that represent the column fields in a GridView control.

ColumnsGenerator ColumnsGenerator ColumnsGenerator ColumnsGenerator

取得或設定控制項,這個控制項將自動針對使用 ASP.NET 動態資料功能的 GridView 控制項產生資料行。Gets or sets the control that will automatically generate the columns for a GridView control that uses ASP.NET Dynamic Data features.

Context Context Context Context

取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

取得複合資料繫結控制項內之子控制項的集合。Gets a collection of the child controls within the composite data-bound control.

(Inherited from CompositeDataBoundControl)
ControlStyle ControlStyle ControlStyle ControlStyle

取得 Web 伺服器控制項的樣式。Gets the style of the Web server control. 這個屬性主要由控制項開發人員使用。This property is used primarily by control developers.

(Inherited from WebControl)
ControlStyleCreated ControlStyleCreated ControlStyleCreated ControlStyleCreated

取得值,指出 Style 物件是否已經為 ControlStyle 屬性建立。Gets a value indicating whether a Style object has been created for the ControlStyle property. 這個屬性主要由控制項開發人員使用。This property is primarily used by control developers.

(Inherited from WebControl)
CssClass CssClass CssClass CssClass

取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Inherited from WebControl)
DataItemContainer DataItemContainer DataItemContainer DataItemContainer

如果命名容器實作 IDataItemContainer,則取得命名容器的參考。Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeyNames DataKeyNames DataKeyNames DataKeyNames

取得或設定陣列,這個陣列包含 GridView 控制項中所顯示項目的主索引鍵欄位名稱。Gets or sets an array that contains the names of the primary key fields for the items displayed in a GridView control.

DataKeys DataKeys DataKeys DataKeys

取得 DataKey 物件的集合,其表示 GridView 控制項中每個資料列的資料索引鍵值。Gets a collection of DataKey objects that represent the data key value of each row in a GridView control.

DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

如果命名容器實作 IDataKeysControl,則取得命名容器的參考。Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DataMember DataMember DataMember DataMember

取得或設定資料繫結控制項繫結至的資料清單名稱 (如果資料來源包含多個不同資料項目清單)。Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items.

(Inherited from DataBoundControl)
DataSource DataSource DataSource DataSource

取得或設定資料繫結控制項從中擷取其資料項目清單的物件。Gets or sets the object from which the data-bound control retrieves its list of data items.

(Inherited from BaseDataBoundControl)
DataSourceID DataSourceID DataSourceID DataSourceID

取得或設定控制項 ID,資料繫結控制項從該 ID 擷取其資料項目清單。Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Inherited from DataBoundControl)
DataSourceObject DataSourceObject DataSourceObject DataSourceObject

取得物件,這個物件會實作可提供物件資料內容之存取權的 IDataSource 介面。Gets an object that implements the IDataSource interface, which provides access to the object's data content.

(Inherited from DataBoundControl)
DeleteMethod DeleteMethod DeleteMethod DeleteMethod

為了刪除資料,取得或設定要呼叫的方法名稱。Gets or sets the name of the method to call in order to delete data.

DesignMode DesignMode DesignMode DesignMode

取得值,指出控制項是否正用於設計介面上。Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EditIndex EditIndex EditIndex EditIndex

取得或設定要編輯之資料列的索引。Gets or sets the index of the row to edit.

EditRowStyle EditRowStyle EditRowStyle EditRowStyle

取得 TableItemStyle 物件的參考,其可讓您設定 GridView 控制項中已選取用於編輯之資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the row selected for editing in a GridView control.

EmptyDataRowStyle EmptyDataRowStyle EmptyDataRowStyle EmptyDataRowStyle

取得 TableItemStyle 物件的參考,其可讓您設定在 GridView 控制項繫結至不包含任何資料錄的資料來源時所呈現之空白資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the empty data row rendered when a GridView control is bound to a data source that does not contain any records.

EmptyDataTemplate EmptyDataTemplate EmptyDataTemplate EmptyDataTemplate

取得或設定空白資料之使用者定義的內容,該資料列呈現於 GridView 控制項繫結至不包含任何資料錄的資料來源時。Gets or sets the user-defined content for the empty data row rendered when a GridView control is bound to a data source that does not contain any records.

EmptyDataText EmptyDataText EmptyDataText EmptyDataText

取得或設定空白資料列中顯示的文字,該資料列呈現於 GridView 控制項繫結至不包含任何資料錄的資料來源時。Gets or sets the text to display in the empty data row rendered when a GridView control is bound to a data source that does not contain any records.

Enabled Enabled Enabled Enabled

取得或設定值,指出 Web 伺服器控制項是否啟用。Gets or sets a value indicating whether the Web server control is enabled.

(Inherited from WebControl)
EnableModelValidation EnableModelValidation EnableModelValidation EnableModelValidation

取得或設定值,這個值表示驗證程式控制項是否要處理在插入或更新作業期間發生的例外狀況。Gets or sets a value that indicates whether a validator control will handle exceptions that occur during insert or update operations.

EnablePersistedSelection EnablePersistedSelection EnablePersistedSelection EnablePersistedSelection

取得或設定值,指出是根據索引還是資料索引鍵值來選取資料列。Gets or sets a value that indicates whether the selection of a row is based on index or on data-key values.

EnableSortingAndPagingCallbacks EnableSortingAndPagingCallbacks EnableSortingAndPagingCallbacks EnableSortingAndPagingCallbacks

取得或設定值,指出用戶端回呼是否用於排序和分頁作業。Gets or sets a value indicating whether client-side callbacks are used for sorting and paging operations.

EnableTheming EnableTheming EnableTheming EnableTheming

取得或設定值,指出佈景主題是否套用至此控制項。Gets or sets a value indicating whether themes apply to this control.

(Inherited from WebControl)
EnableViewState EnableViewState EnableViewState EnableViewState

取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

取得控制項事件處理常式委派 (Delegate) 的清單。Gets a list of event handler delegates for the control. 這個屬性是唯讀的。This property is read-only.

(Inherited from Control)
Font Font Font Font

取得與 Web 伺服器控制項關聯的字型屬性。Gets the font properties associated with the Web server control.

(Inherited from WebControl)
FooterRow FooterRow FooterRow FooterRow

取得 GridViewRow 物件,其表示 GridView 控制項中的頁尾資料列。Gets a GridViewRow object that represents the footer row in a GridView control.

FooterStyle FooterStyle FooterStyle FooterStyle

取得 TableItemStyle 物件的參考,其可讓您設定 GridView 控制項中頁尾 (Footer) 資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the footer row in a GridView control.

ForeColor ForeColor ForeColor ForeColor

取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Inherited from WebControl)
GridLines GridLines GridLines GridLines

取得或設定 GridView 控制項的格線樣式。Gets or sets the gridline style for a GridView control.

HasAttributes HasAttributes HasAttributes HasAttributes

取得值,指出控制項是否已經設定屬性。Gets a value indicating whether the control has attributes set.

(Inherited from WebControl)
HasChildViewState HasChildViewState HasChildViewState HasChildViewState

取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
HeaderRow HeaderRow HeaderRow HeaderRow

取得 GridViewRow 物件,表示 GridView 控制項中的標頭資料列。Gets a GridViewRow object that represents the header row in a GridView control.

HeaderStyle HeaderStyle HeaderStyle HeaderStyle

取得 TableItemStyle 物件的參考,其可讓您設定 GridView 控制項之標頭資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the header row in a GridView control.

Height Height Height Height

取得或設定 Web 伺服器控制項的高度。Gets or sets the height of the Web server control.

(Inherited from WebControl)
HorizontalAlign HorizontalAlign HorizontalAlign HorizontalAlign

取得或設定頁面上 GridView 控制項的水平對齊。Gets or sets the horizontal alignment of a GridView control on the page.

IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

如需這個成員的說明,請參閱 ControlBuilderFor a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

如需這個成員的說明,請參閱 UserDataFor a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

取得或設定指派給伺服器控制項的程式設計識別項。Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

如需這個成員的說明,請參閱 DataBindingsFor a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

如需這個成員的說明,請參閱 HasDataBindingsFor a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

取得用來分隔控制項識別項的字元。Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

如需這個成員的說明,請參閱 ExpressionsFor a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

如需這個成員的說明,請參閱 HasExpressionsFor a description of this member, see HasExpressions.

(Inherited from Control)
Initialized Initialized Initialized Initialized

取得值,指出是否已初始化資料繫結控制項。Gets a value indicating whether the data-bound control has been initialized.

(Inherited from BaseDataBoundControl)
InsertMethod InsertMethod InsertMethod InsertMethod

為了插入資料,取得或設定要呼叫的方法名稱。Gets or sets the name of the method to call in order to insert data.

(Inherited from CompositeDataBoundControl)
IsBoundUsingDataSourceID IsBoundUsingDataSourceID IsBoundUsingDataSourceID IsBoundUsingDataSourceID

取得值,指出是否已設定 DataSourceID 屬性。Gets a value indicating whether the DataSourceID property is set.

(Inherited from BaseDataBoundControl)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

取得值,指出這個控制項中所包含的控制項是否有控制項狀態。Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsDataBindingAutomatic IsDataBindingAutomatic IsDataBindingAutomatic IsDataBindingAutomatic

取得值,指出資料繫結是否為自動。Gets a value that indicates whether data binding is automatic.

(Inherited from BaseDataBoundControl)
IsEnabled IsEnabled IsEnabled IsEnabled

取得值,指出是否啟用控制項。Gets a value indicating whether the control is enabled.

(Inherited from WebControl)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsUsingModelBinders IsUsingModelBinders IsUsingModelBinders IsUsingModelBinders

取得值,指出模型繫結是否正在使用。Gets a value that indicates whether model binding is in use.

(Inherited from CompositeDataBoundControl)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

取得值,指出這個控制項是否已啟用檢視狀態。Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
ItemType ItemType ItemType ItemType

取得或設定強型別資料繫結的資料項目型別名稱。Gets or sets the name of the data item type for strongly typed data binding.

(Inherited from DataBoundControl)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
NamingContainer NamingContainer NamingContainer NamingContainer

取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 ID 屬性值的伺服器控制項之間作區別。Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Page Page Page Page

取得含有伺服器控制項的 Page 執行個體的參考。Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
PageCount PageCount PageCount PageCount

取得 GridView 控制項中顯示資料來源之資料錄所需要的頁數。Gets the number of pages required to display the records of the data source in a GridView control.

PageIndex PageIndex PageIndex PageIndex

取得或設定目前顯示頁面的索引。Gets or sets the index of the currently displayed page.

PagerSettings PagerSettings PagerSettings PagerSettings

取得 PagerSettings 物件的參考,其可讓您設定 GridView 控制項中頁面巡覽區按鈕的屬性。Gets a reference to the PagerSettings object that enables you to set the properties of the pager buttons in a GridView control.

PagerStyle PagerStyle PagerStyle PagerStyle

取得 TableItemStyle 物件的參考,其可讓您設定 GridView 控制項之頁面巡覽區資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the pager row in a GridView control.

PagerTemplate PagerTemplate PagerTemplate PagerTemplate

取得或設定 GridView 控制項中頁面巡覽列的自訂內容。Gets or sets the custom content for the pager row in a GridView control.

PageSize PageSize PageSize PageSize

取得或設定 GridView 控制項之頁面上顯示的資料錄數。Gets or sets the number of records to display on a page in a GridView control.

Parent Parent Parent Parent

在網頁控制階層架構中取得伺服器控制項之父控制項的參考。Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
RequiresDataBinding RequiresDataBinding RequiresDataBinding RequiresDataBinding

取得或設定值,指出是否應該呼叫 DataBind() 方法。Gets or sets a value indicating whether the DataBind() method should be called.

(Inherited from BaseDataBoundControl)
RowHeaderColumn RowHeaderColumn RowHeaderColumn RowHeaderColumn

取得或設定資料行的名稱,做為 GridView 控制項的資料行行首。Gets or sets the name of the column to use as the column header for the GridView control. 這個屬性可讓協助技術裝置的使用者更容易存取控制項。This property is provided to make the control more accessible to users of assistive technology devices.

Rows Rows Rows Rows

取得 GridViewRow 物件的集合,其表示 GridView 控制項中的資料列。Gets a collection of GridViewRow objects that represent the data rows in a GridView control.

RowStyle RowStyle RowStyle RowStyle

取得 TableItemStyle 物件的參考,其可讓您設定 GridView 控制項中資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the data rows in a GridView control.

SelectArguments SelectArguments SelectArguments SelectArguments

取得 DataSourceSelectArguments 物件,當從資料來源控制項擷取資料時資料繫結控制項會使用它。Gets a DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control.

(Inherited from DataBoundControl)
SelectedDataKey SelectedDataKey SelectedDataKey SelectedDataKey

取得 DataKey 物件,其包含 GridView 控制項中已選取資料列的資料索引鍵值。Gets the DataKey object that contains the data key value for the selected row in a GridView control.

SelectedIndex SelectedIndex SelectedIndex SelectedIndex

取得或設定 GridView 控制項中已選取資料列的索引。Gets or sets the index of the selected row in a GridView control.

SelectedPersistedDataKey SelectedPersistedDataKey SelectedPersistedDataKey SelectedPersistedDataKey

GridView 控制項中持續選取的項目取得或設定資料索引鍵值。Gets or sets the data-key value for the persisted selected item in a GridView control.

SelectedRow SelectedRow SelectedRow SelectedRow

取得 GridViewRow 物件的參考,其表示控制項中已選取的資料列。Gets a reference to a GridViewRow object that represents the selected row in the control.

SelectedRowStyle SelectedRowStyle SelectedRowStyle SelectedRowStyle

取得 TableItemStyle 物件的參考,其可讓您設定 GridView 控制項中已選取資料列的外觀。Gets a reference to the TableItemStyle object that enables you to set the appearance of the selected row in a GridView control.

SelectedValue SelectedValue SelectedValue SelectedValue

取得 GridView 控制項中已選取資料列的資料索引鍵值。Gets the data key value of the selected row in a GridView control.

SelectMethod SelectMethod SelectMethod SelectMethod

為了讀取資料要呼叫的方法的名稱。The name of the method to call in order to read data.

(Inherited from DataBoundControl)
ShowFooter ShowFooter ShowFooter ShowFooter

取得或設定值,指出是否在 GridView 控制項中顯示頁尾資料列。Gets or sets a value indicating whether the footer row is displayed in a GridView control.

ShowHeader ShowHeader ShowHeader ShowHeader

取得或設定值,指出是否在 GridView 控制項中顯示標頭資料列。Gets or sets a value indicating whether the header row is displayed in a GridView control.

ShowHeaderWhenEmpty ShowHeaderWhenEmpty ShowHeaderWhenEmpty ShowHeaderWhenEmpty

取得或設定值,這個值表示是否要在 GridView 控制項中的資料行未包含資料時,顯示資料行的標題。Gets or sets a value that indicates whether the heading of a column in the GridView control is visible when the column has no data.

Site Site Site Site

當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

取得或設定要套用至控制項的面板。Gets or sets the skin to apply to the control.

(Inherited from WebControl)
SortDirection SortDirection SortDirection SortDirection

取得正在排序之資料行的排序方向。Gets the sort direction of the column being sorted.

SortedAscendingCellStyle SortedAscendingCellStyle SortedAscendingCellStyle SortedAscendingCellStyle

取得或設定以遞增順序排序 GridView 資料行時,資料行的 CSS 樣式。Gets or sets the CSS style for a GridView column when the column is sorted in ascending order.

SortedAscendingHeaderStyle SortedAscendingHeaderStyle SortedAscendingHeaderStyle SortedAscendingHeaderStyle

取得或設定以遞增順序排序 GridView 資料行時,要套用至資料行標題的 CSS 樣式。Gets or sets the CSS style to apply to a GridView column heading when the column is sorted in ascending order.

SortedDescendingCellStyle SortedDescendingCellStyle SortedDescendingCellStyle SortedDescendingCellStyle

取得或設定以遞減順序排序 GridView 資料行時,資料行的樣式。Gets or sets the style of a GridView column when the column is sorted in descending order.

SortedDescendingHeaderStyle SortedDescendingHeaderStyle SortedDescendingHeaderStyle SortedDescendingHeaderStyle

取得或設定以遞減順序排序 GridView 資料行時,要套用至資料行標題的樣式。Gets or sets the style to apply to a GridView column heading when the column is sorted in descending order.

SortExpression SortExpression SortExpression SortExpression

取得與正在排序之資料行關聯的排序運算式。Gets the sort expression associated with the column or columns being sorted.

Style Style Style Style

取得文字屬性的集合,將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Inherited from WebControl)
SupportsDisabledAttribute SupportsDisabledAttribute SupportsDisabledAttribute SupportsDisabledAttribute

取得值,這個值表示當控制項的 IsEnabled 屬性為 false 時,控制項是否應該將呈現之 HTML 項目的 disabled 屬性設為 "disabled"。Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Inherited from BaseDataBoundControl)
TabIndex TabIndex TabIndex TabIndex

取得或設定 Web 伺服器控制項的定位索引。Gets or sets the tab index of the Web server control.

(Inherited from WebControl)
TagKey TagKey TagKey TagKey

取得 GridView 控制項的 HtmlTextWriterTag 值。Gets the HtmlTextWriterTag value for the GridView control.

TagName TagName TagName TagName

取得控制項標記的名稱。Gets the name of the control tag. 這個屬性主要由控制項開發人員使用。This property is used primarily by control developers.

(Inherited from WebControl)
TemplateControl TemplateControl TemplateControl TemplateControl

取得或設定包含了此控制項之樣板的參考。Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

取得包含目前伺服器控制項的 PageUserControl 的虛擬目錄。Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
ToolTip ToolTip ToolTip ToolTip

取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Inherited from WebControl)
TopPagerRow TopPagerRow TopPagerRow TopPagerRow

取得 GridViewRow 物件,其表示 GridView 控制項中的頂端頁面巡覽列。Gets a GridViewRow object that represents the top pager row in a GridView control.

UniqueID UniqueID UniqueID UniqueID

取得伺服器控制項唯一的、符合階層架構的識別項。Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
UpdateMethod UpdateMethod UpdateMethod UpdateMethod

為了更新資料,取得或設定要呼叫的方法名稱。Gets or sets the name of the method to call in order to update data.

UseAccessibleHeader UseAccessibleHeader UseAccessibleHeader UseAccessibleHeader

取得或設定值,指出 GridView 控制項是否以可存取格式呈現其標頭。Gets or sets a value indicating whether a GridView control renders its header in an accessible format. 這個屬性可讓協助技術裝置的使用者更容易存取控制項。This property is provided to make the control more accessible to users of assistive technology devices.

ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState ViewState ViewState ViewState

取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

取得值,指出 StateBag 物件是否不區分大小寫。Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

取得或設定這個控制項的檢視狀態模式。Gets or sets the view-state mode of this control.

(Inherited from Control)
VirtualItemCount VirtualItemCount VirtualItemCount VirtualItemCount

取得或設定使用自訂分頁時,GridView 控制項所繫結之資料來源中項目的虛擬數目。Gets or sets the virtual number of items in the data source that the GridView control is bound to when custom paging is used.

Visible Visible Visible Visible

取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Inherited from Control)
Width Width Width Width

取得或設定 Web 伺服器控制項的寬度。Gets or sets the width of the Web server control.

(Inherited from WebControl)

方法

AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter)

將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriterTag 中。Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. 這個方法主要由控制項開發人員使用。This method is used primarily by control developers.

(Inherited from WebControl)
AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

在子控制項加入 Control 物件的 Controls 集合後呼叫。Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object)

通知伺服器控制項,XML 或 HTML 項目已剖析,並將項目加入伺服器控制項的 ControlCollection 物件中。Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyle(Style) ApplyStyle(Style) ApplyStyle(Style) ApplyStyle(Style)

將指定樣式的任何非空白項目加入到 Web 控制項中,覆寫控制項的任何現有的樣式項目。Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. 這個方法主要由控制項開發人員使用。This method is primarily used by control developers.

(Inherited from WebControl)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

將頁面樣式表中所定義的樣式屬性套用至控制項。Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

開始進行轉譯資料的設計階段追蹤。Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

收集伺服器控制項的相關資訊,並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

將快取的 ClientID 值設定為 nullSets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

刪除伺服器控制項之子控制項的控制項狀態資訊。Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

刪除所有伺服器控制項之子控制項的檢視狀態資訊。Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 InheritSets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
ConfirmInitState() ConfirmInitState() ConfirmInitState() ConfirmInitState()

設定資料繫結控制項之初始化的狀態。Sets the initialized state of the data-bound control.

(Inherited from BaseDataBoundControl)
CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl)

將不被 Style 物件封裝的屬性從指定的 Web 伺服器控制項複製到呼叫這個方法的 Web 伺服器控制項上。Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. 這個方法主要由控制項開發人員使用。This method is used primarily by control developers.

(Inherited from WebControl)
CreateAutoGeneratedColumn(AutoGeneratedFieldProperties) CreateAutoGeneratedColumn(AutoGeneratedFieldProperties) CreateAutoGeneratedColumn(AutoGeneratedFieldProperties) CreateAutoGeneratedColumn(AutoGeneratedFieldProperties)

建立自動產生的資料行欄位。Creates an automatically generated column field.

CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

根據儲存在檢視狀態中的值,建立用來呈現複合資料繫結控制項的控制項階層架構。Creates the control hierarchy that is used to render a composite data-bound control based on the values that are stored in view state.

(Inherited from CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean) CreateChildControls(IEnumerable, Boolean) CreateChildControls(IEnumerable, Boolean) CreateChildControls(IEnumerable, Boolean)

使用特定資料來源建立用於呈現 GridView 控制項的控制階層架構。Creates the control hierarchy used to render the GridView control using the specified data source.

CreateChildTable() CreateChildTable() CreateChildTable() CreateChildTable()

建立新的子資料表。Creates a new child table.

CreateColumns(PagedDataSource, Boolean) CreateColumns(PagedDataSource, Boolean) CreateColumns(PagedDataSource, Boolean) CreateColumns(PagedDataSource, Boolean)

建立用於建置控制階層架構的資料行欄位集合。Creates the set of column fields used to build the control hierarchy.

CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

建立新的 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
CreateControlStyle() CreateControlStyle() CreateControlStyle() CreateControlStyle()

建立控制項的預設樣式。Creates the default style for the control.

CreateDataSourceSelectArguments() CreateDataSourceSelectArguments() CreateDataSourceSelectArguments() CreateDataSourceSelectArguments()

建立 DataSourceSelectArguments 物件,其包含傳遞至資料來源用於處理的引數。Creates the DataSourceSelectArguments object that contains the arguments that get passed to the data source for processing.

CreateRow(Int32, Int32, DataControlRowType, DataControlRowState) CreateRow(Int32, Int32, DataControlRowType, DataControlRowState) CreateRow(Int32, Int32, DataControlRowType, DataControlRowState) CreateRow(Int32, Int32, DataControlRowType, DataControlRowState)

建立 GridView 控制項中的資料列。Creates a row in the GridView control.

DataBind() DataBind() DataBind() DataBind()

將資料來源繫結至 GridView 控制項。Binds the data source to the GridView control. 這個方法無法被繼承。This method cannot be inherited.

DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) DataBind(Boolean)

使用會引發 DataBinding 事件的選項,繫結資料來源至叫用的伺服器控制項及其所有子控制項。Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

繫結資料來源至伺服器控制項的子控制項。Binds a data source to the server control's child controls.

(Inherited from Control)
DeleteRow(Int32) DeleteRow(Int32) DeleteRow(Int32) DeleteRow(Int32)

刪除資料來源中指定索引的資料錄。Deletes the record at the specified index from the data source.

Dispose() Dispose() Dispose() Dispose()

啟用伺服器控制項,在它從記憶體釋放之前執行最後清除。Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

結束轉譯資料的設計階段追蹤。Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

判斷伺服器控制項是否包含子控制項。Determines whether the server control contains child controls. 如果不包含,則建立子控制項。If it does not, it creates child controls.

(Inherited from Control)
EnsureDataBound() EnsureDataBound() EnsureDataBound() EnsureDataBound()

如果設定了 DataBind() 屬性且資料繫結控制項標記為需要繫結,則會呼叫 DataSourceID 方法。Calls the DataBind() method if the DataSourceID property is set and the data-bound control is marked to require binding.

(Inherited from BaseDataBoundControl)
EnsureID() EnsureID() EnsureID() EnsureID()

為尚未指定識別項的控制項,建立識別項。Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractRowValues(IOrderedDictionary, GridViewRow, Boolean, Boolean) ExtractRowValues(IOrderedDictionary, GridViewRow, Boolean, Boolean) ExtractRowValues(IOrderedDictionary, GridViewRow, Boolean, Boolean) ExtractRowValues(IOrderedDictionary, GridViewRow, Boolean, Boolean)

擷取在指定資料列內宣告之每個欄位的值,並將它們儲存在指定的 IOrderedDictionary 物件中。Retrieves the values of each field declared within the specified row and stores them in the specified IOrderedDictionary object.

FindControl(String) FindControl(String) FindControl(String) FindControl(String)

在目前命名容器搜尋具有指定 id 參數的伺服器控制項。Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

使用指定的 id 和有助於搜尋之 pathOffset 參數中所指定的整數,在目前的命名容器中搜尋伺服器控制項。Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. 您不應該覆寫這個版本的 FindControl 方法。You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

設定控制項的輸入焦點。Sets input focus to a control.

(Inherited from Control)
GetCallbackResult() GetCallbackResult() GetCallbackResult() GetCallbackResult()

傳回以控制項為目標之回呼事件的結果。Returns the result of a callback event that targets a control.

GetCallbackScript(IButtonControl, String) GetCallbackScript(IButtonControl, String) GetCallbackScript(IButtonControl, String) GetCallbackScript(IButtonControl, String)

為執行排序作業的按鈕建立回呼指令碼。Creates the callback script for a button that performs a sorting operation.

GetData() GetData() GetData() GetData()

擷取 DataSourceView 物件,資料繫結控制項會用來執行資料作業。Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

(Inherited from DataBoundControl)
GetDataSource() GetDataSource() GetDataSource() GetDataSource()

擷取與資料繫結控制項關聯的 IDataSource 介面 (如果有的話)。Retrieves the IDataSource interface that the data-bound control is associated with, if any.

(Inherited from DataBoundControl)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

取得控制項的設計階段資料。Gets design-time data for a control.

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

取得會對應於一組路由參數的 URL。Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

取得會對應於一組路由參數的 URL。Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

取得 URL,此 URL 對應於一組路由參數及一個路由名稱。Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

取得 URL,此 URL 對應於一組路由參數及一個路由名稱。Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

傳回指定之控制項 UniqueID 屬性的前置部分。Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

判斷伺服器控制項是否包含任何子控制項。Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

傳回值,指出控制項或任何子控制項的事件是否已註冊。Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
InitializePager(GridViewRow, Int32, PagedDataSource) InitializePager(GridViewRow, Int32, PagedDataSource) InitializePager(GridViewRow, Int32, PagedDataSource) InitializePager(GridViewRow, Int32, PagedDataSource)

初始化啟用分頁功能時顯示的頁面巡覽列。Initializes the pager row displayed when the paging feature is enabled.

InitializeRow(GridViewRow, DataControlField[]) InitializeRow(GridViewRow, DataControlField[]) InitializeRow(GridViewRow, DataControlField[]) InitializeRow(GridViewRow, DataControlField[])

初始化 GridView 控制項中的資料列。Initializes a row in the GridView control.

IsBindableType(Type) IsBindableType(Type) IsBindableType(Type) IsBindableType(Type)

決定指定的資料類型是否可以繫結至 GridView 控制項中的資料行。Determines whether the specified data type can be bound to a column in a GridView control.

IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

判斷伺服器控制項是否只儲存常值內容。Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

載入需要保存之 GridView 控制項中屬性的狀態,即使 EnableViewState 屬性設為 falseLoads the state of the properties in the GridView control that need to be persisted, even when the EnableViewState property is set to false.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

載入先前儲存的 GridView 控制項檢視狀態。Loads the previously saved view state of the GridView control.

MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MarkAsDataBound() MarkAsDataBound() MarkAsDataBound() MarkAsDataBound()

將檢視狀態中的控制項狀態設為已成功繫結至資料。Sets the state of the control in view state as successfully bound to data.

(Inherited from DataBoundControl)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
MergeStyle(Style) MergeStyle(Style) MergeStyle(Style) MergeStyle(Style)

將指定樣式的任何非空白項目複製到 Web 控制項,但不覆寫控制項的任何現有樣式項目。Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. 這個方法主要由控制項開發人員使用。This method is used primarily by control developers.

(Inherited from WebControl)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

決定 Web 伺服器控制項的事件是否要向上傳遞至網頁的使用者介面 (UI) 伺服器控制階層架構。Determines whether the event for the Web server control is passed up the page's user interface (UI) server control hierarchy.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

引發 CreatingModelDataSource 事件。Raises the CreatingModelDataSource event.

(Inherited from DataBoundControl)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

引發 DataBinding 事件。Raises the DataBinding event.

(Inherited from Control)
OnDataBound(EventArgs) OnDataBound(EventArgs) OnDataBound(EventArgs) OnDataBound(EventArgs)

引發 DataBound 事件。Raises the DataBound event.

(Inherited from BaseDataBoundControl)
OnDataPropertyChanged() OnDataPropertyChanged() OnDataPropertyChanged() OnDataPropertyChanged()

GridViewDataMemberDataSource 屬性變更後,將 DataSourceID 控制項重新繫結至其資料。Rebinds the GridView control to its data after the DataMember, DataSource, or DataSourceID property is changed.

OnDataSourceViewChanged(Object, EventArgs) OnDataSourceViewChanged(Object, EventArgs) OnDataSourceViewChanged(Object, EventArgs) OnDataSourceViewChanged(Object, EventArgs)

引發 DataSourceViewChanged 事件。Raises the DataSourceViewChanged event.

OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

引發 Init 事件。Raises the Init event.

OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

處理 Load 事件。Handles the Load event.

(Inherited from DataBoundControl)
OnPageIndexChanged(EventArgs) OnPageIndexChanged(EventArgs) OnPageIndexChanged(EventArgs) OnPageIndexChanged(EventArgs)

引發 PageIndexChanged 事件。Raises the PageIndexChanged event.

OnPageIndexChanging(GridViewPageEventArgs) OnPageIndexChanging(GridViewPageEventArgs) OnPageIndexChanging(GridViewPageEventArgs) OnPageIndexChanging(GridViewPageEventArgs)

引發 PageIndexChanging 事件。Raises the PageIndexChanging event.

OnPagePreLoad(Object, EventArgs) OnPagePreLoad(Object, EventArgs) OnPagePreLoad(Object, EventArgs) OnPagePreLoad(Object, EventArgs)

設定資料繫結控制項在載入控制項之前的初始化狀態。Sets the initialized state of the data-bound control before the control is loaded.

OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

引發 PreRender 事件。Raises the PreRender event.

OnRowCancelingEdit(GridViewCancelEditEventArgs) OnRowCancelingEdit(GridViewCancelEditEventArgs) OnRowCancelingEdit(GridViewCancelEditEventArgs) OnRowCancelingEdit(GridViewCancelEditEventArgs)

引發 RowCancelingEdit 事件。Raises the RowCancelingEdit event.

OnRowCommand(GridViewCommandEventArgs) OnRowCommand(GridViewCommandEventArgs) OnRowCommand(GridViewCommandEventArgs) OnRowCommand(GridViewCommandEventArgs)

引發 RowCommand 事件。Raises the RowCommand event.

OnRowCreated(GridViewRowEventArgs) OnRowCreated(GridViewRowEventArgs) OnRowCreated(GridViewRowEventArgs) OnRowCreated(GridViewRowEventArgs)

引發 RowCreated 事件。Raises the RowCreated event.

OnRowDataBound(GridViewRowEventArgs) OnRowDataBound(GridViewRowEventArgs) OnRowDataBound(GridViewRowEventArgs) OnRowDataBound(GridViewRowEventArgs)

引發 RowDataBound 事件。Raises the RowDataBound event.

OnRowDeleted(GridViewDeletedEventArgs) OnRowDeleted(GridViewDeletedEventArgs) OnRowDeleted(GridViewDeletedEventArgs) OnRowDeleted(GridViewDeletedEventArgs)

引發 RowDeleted 事件。Raises the RowDeleted event.

OnRowDeleting(GridViewDeleteEventArgs) OnRowDeleting(GridViewDeleteEventArgs) OnRowDeleting(GridViewDeleteEventArgs) OnRowDeleting(GridViewDeleteEventArgs)

引發 RowDeleting 事件。Raises the RowDeleting event.

OnRowEditing(GridViewEditEventArgs) OnRowEditing(GridViewEditEventArgs) OnRowEditing(GridViewEditEventArgs) OnRowEditing(GridViewEditEventArgs)

引發 RowEditing 事件。Raises the RowEditing event.

OnRowUpdated(GridViewUpdatedEventArgs) OnRowUpdated(GridViewUpdatedEventArgs) OnRowUpdated(GridViewUpdatedEventArgs) OnRowUpdated(GridViewUpdatedEventArgs)

引發 RowUpdated 事件。Raises the RowUpdated event.

OnRowUpdating(GridViewUpdateEventArgs) OnRowUpdating(GridViewUpdateEventArgs) OnRowUpdating(GridViewUpdateEventArgs) OnRowUpdating(GridViewUpdateEventArgs)

引發 RowUpdating 事件。Raises the RowUpdating event.

OnSelectedIndexChanged(EventArgs) OnSelectedIndexChanged(EventArgs) OnSelectedIndexChanged(EventArgs) OnSelectedIndexChanged(EventArgs)

引發 SelectedIndexChanged 事件。Raises the SelectedIndexChanged event.

OnSelectedIndexChanging(GridViewSelectEventArgs) OnSelectedIndexChanging(GridViewSelectEventArgs) OnSelectedIndexChanging(GridViewSelectEventArgs) OnSelectedIndexChanging(GridViewSelectEventArgs)

引發 SelectedIndexChanging 事件。Raises the SelectedIndexChanging event.

OnSorted(EventArgs) OnSorted(EventArgs) OnSorted(EventArgs) OnSorted(EventArgs)

引發 Sorted 事件。Raises the Sorted event.

OnSorting(GridViewSortEventArgs) OnSorting(GridViewSortEventArgs) OnSorting(GridViewSortEventArgs) OnSorting(GridViewSortEventArgs)

引發 Sorting 事件。Raises the Sorting event.

OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

引發 Unload 事件。Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

取得用來讀取檔案的 StreamGets a Stream used to read a file.

(Inherited from Control)
PerformDataBinding(IEnumerable) PerformDataBinding(IEnumerable) PerformDataBinding(IEnumerable) PerformDataBinding(IEnumerable)

將指定的資料來源繫結至 GridView 控制項。Binds the specified data source to the GridView control.

PerformSelect() PerformSelect() PerformSelect() PerformSelect()

從關聯的資料來源擷取資料。Retrieves data from the associated data source.

(Inherited from DataBoundControl)
PrepareControlHierarchy() PrepareControlHierarchy() PrepareControlHierarchy() PrepareControlHierarchy()

建立控制階層架構。Establishes the control hierarchy.

RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

指派事件的任何來源和它的資訊至控制項的父控制項。Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RaiseCallbackEvent(String) RaiseCallbackEvent(String) RaiseCallbackEvent(String) RaiseCallbackEvent(String)

建立 GetCallbackEventReference(Control, String, String, String, Boolean) 方法中回呼處理常式的引數。Creates the arguments for the callback handler in the GetCallbackEventReference(Control, String, String, String, Boolean) method.

RaisePostBackEvent(String) RaisePostBackEvent(String) RaisePostBackEvent(String) RaisePostBackEvent(String)

回傳至伺服器時引發 GridView 控制項的適當事件。Raises the appropriate events for the GridView control when it posts back to the server.

RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Control 物件的 Controls 集合中移除子控制項之後呼叫。Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

使用指定的 HtmlTextWriter 物件,向用戶端瀏覽器呈現 Web 伺服器控制項內容。Renders the Web server control content to the client's browser using the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter)

將控制項的 HTML 開頭標記呈現在指定的寫入器中。Renders the HTML opening tag of the control to the specified writer. 這個方法主要由控制項開發人員使用。This method is used primarily by control developers.

(Inherited from WebControl)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

輸出伺服器控制項之子控制項的內容至提供的 HtmlTextWriter 物件,這個物件會寫入用戶端上所要呈現的內容。Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter)

將控制項的內容呈現在指定的寫入器。Renders the contents of the control to the specified writer. 這個方法主要由控制項開發人員使用。This method is used primarily by control developers.

(Inherited from WebControl)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件,並在啟用追蹤時儲存控制項的追蹤資訊。Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 HtmlTextWriter 物件,輸出伺服器控制項內容至提供的 ControlAdapter 物件。Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter)

將控制項的 HTML 結尾標記呈現至指定的寫入器。Renders the HTML closing tag of the control into the specified writer. 這個方法主要由控制項開發人員使用。This method is used primarily by control developers.

(Inherited from WebControl)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

取得負責呈現指定之控制項的控制項配置器。Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

取得瀏覽器可使用的 URL。Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

將 URL 轉換為要求用戶端可使用的 URL。Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

儲存需要保存之 GridView 控制項中屬性的狀態,即使 EnableViewState 屬性設為 falseSaves the state of the properties in the GridView control that need to be persisted, even when the EnableViewState property is set to false.

SaveViewState() SaveViewState() SaveViewState() SaveViewState()

載入先前儲存的 GridView 控制項檢視狀態。Loads the previously saved view state of the GridView control.

SelectRow(Int32) SelectRow(Int32) SelectRow(Int32) SelectRow(Int32)

選取要在 GridView 控制項中編輯的資料列。Selects the row to edit in a GridView control.

SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

設定控制項的設計階段資料。Sets design-time data for a control.

(Inherited from Control)
SetEditRow(Int32) SetEditRow(Int32) SetEditRow(Int32) SetEditRow(Int32)

使用指定的資料列索引,將 GridView 控制項中的資料列設為編輯模式。Puts a row in edit mode in a GridView control by using the specified row index.

SetPageIndex(Int32) SetPageIndex(Int32) SetPageIndex(Int32) SetPageIndex(Int32)

使用資料列索引,設定 GridView 控制項的頁面索引。Sets the page index of the GridView control by using the row index.

SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

指定事件處理常式委派,以呈現伺服器控制項及其內容至其父控制項。Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object)

使用追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object)

使用追蹤的物體、追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
Sort(String, SortDirection) Sort(String, SortDirection) Sort(String, SortDirection) Sort(String, SortDirection)

根據指定排序運算式和方向對 GridView 控制項進行排序。Sorts the GridView control based on the specified sort expression and direction.

ToString() ToString() ToString() ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

追蹤 GridView 控制項的檢視狀態變更,以便可將其存儲在該控制項的 StateBag 物件中。Tracks view-state changes to the GridView control so they can be stored in the control's StateBag object. 這個物件可透過 ViewState 屬性存取。This object is accessible through the ViewState property.

UpdateRow(Int32, Boolean) UpdateRow(Int32, Boolean) UpdateRow(Int32, Boolean) UpdateRow(Int32, Boolean)

使用資料列的欄位值更新位於指定資料列索引位置的資料錄。Updates the record at the specified row index using the field values of the row.

ValidateDataSource(Object) ValidateDataSource(Object) ValidateDataSource(Object) ValidateDataSource(Object)

驗證資料繫結控制項繫結至的物件是該資料繫結控制項所使用的物件。Verifies that the object a data-bound control binds to is one it can work with.

(Inherited from DataBoundControl)

事件

CallingDataMethods CallingDataMethods CallingDataMethods CallingDataMethods

正在呼叫資料方法時發生。Occurs when data methods are being called.

(Inherited from DataBoundControl)
CreatingModelDataSource CreatingModelDataSource CreatingModelDataSource CreatingModelDataSource

正在建立 ModelDataSource 物件時發生。Occurs when the ModelDataSource object is being created.

(Inherited from DataBoundControl)
DataBinding DataBinding DataBinding DataBinding

發生於伺服器控制項繫結至資料來源時。Occurs when the server control binds to a data source.

(Inherited from Control)
DataBound DataBound DataBound DataBound

在伺服器控制項繫結至資料來源之後發生。Occurs after the server control binds to a data source.

(Inherited from BaseDataBoundControl)
Disposed Disposed Disposed Disposed

發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

發生於載入伺服器控制項至 Page 物件時。Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PageIndexChanged PageIndexChanged PageIndexChanged PageIndexChanged

按一下其中一個頁面巡覽區按鈕時發生 (但在 GridView 控制項處理分頁作業之後)。Occurs when one of the pager buttons is clicked, but after the GridView control handles the paging operation.

PageIndexChanging PageIndexChanging PageIndexChanging PageIndexChanging

發生於按一下其中一個頁面巡覽區按鈕時,但是在 GridView 控制項處理分頁作業之前。Occurs when one of the pager buttons is clicked, but before the GridView control handles the paging operation.

PreRender PreRender PreRender PreRender

Control 物件載入之後但在呈現之前發生。Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
RowCancelingEdit RowCancelingEdit RowCancelingEdit RowCancelingEdit

按一下處於編輯模式之資料列的 [取消] 按鈕時發生 (但在資料列結束編輯模式之前)。Occurs when the Cancel button of a row in edit mode is clicked, but before the row exits edit mode.

RowCommand RowCommand RowCommand RowCommand

按一下 GridView 控制項中的按鈕時發生。Occurs when a button is clicked in a GridView control.

RowCreated RowCreated RowCreated RowCreated

建立 GridView 控制項中的資料列時發生。Occurs when a row is created in a GridView control.

RowDataBound RowDataBound RowDataBound RowDataBound

資料列繫結至 GridView 控制項中的資料時發生。Occurs when a data row is bound to data in a GridView control.

RowDeleted RowDeleted RowDeleted RowDeleted

按一下資料列的 [刪除] 按鈕時發生 (但在 GridView 控制項刪除資料列之後)。Occurs when a row's Delete button is clicked, but after the GridView control deletes the row.

RowDeleting RowDeleting RowDeleting RowDeleting

按一下資料列的 [刪除] 按鈕時發生 (但在 GridView 控制項刪除資料列之前)。Occurs when a row's Delete button is clicked, but before the GridView control deletes the row.

RowEditing RowEditing RowEditing RowEditing

按一下資料列的 [編輯] 按鈕時發生 (但在 GridView 控制項進入編輯模式之前)。Occurs when a row's Edit button is clicked, but before the GridView control enters edit mode.

RowUpdated RowUpdated RowUpdated RowUpdated

按一下資料列的 [更新] 按鈕時發生 (但在 GridView 控制項更新資料列之後)。Occurs when a row's Update button is clicked, but after the GridView control updates the row.

RowUpdating RowUpdating RowUpdating RowUpdating

按一下資料列的 [更新] 按鈕時發生 (但在 GridView 控制項更新資料列之前)。Occurs when a row's Update button is clicked, but before the GridView control updates the row.

SelectedIndexChanged SelectedIndexChanged SelectedIndexChanged SelectedIndexChanged

按一下資料列的 [選取] 按鈕時發生 (但在 GridView 控制項處理選取作業之後)。Occurs when a row's Select button is clicked, but after the GridView control handles the select operation.

SelectedIndexChanging SelectedIndexChanging SelectedIndexChanging SelectedIndexChanging

按一下資料列的 [選取] 按鈕時發生 (但在 GridView 控制項處理選取作業之前)。Occurs when a row's Select button is clicked, but before the GridView control handles the select operation.

Sorted Sorted Sorted Sorted

按一下排序資料行的超連結時發生 (但在 GridView 控制項處理排序作業之後)。Occurs when the hyperlink to sort a column is clicked, but after the GridView control handles the sort operation.

Sorting Sorting Sorting Sorting

按一下排序資料行的超連結時發生 (但在 GridView 控制項處理排序作業之前)。Occurs when the hyperlink to sort a column is clicked, but before the GridView control handles the sort operation.

Unload Unload Unload Unload

發生於伺服器控制項從記憶體卸載時。Occurs when the server control is unloaded from memory.

(Inherited from Control)

明確介面實作

IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String)

使用指定的名稱,取得 Web 控制項的屬性。Gets an attribute of the Web control with the specified name.

(Inherited from WebControl)
IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String)

將 Web 控制項的屬性設定為指定的名稱和值。Sets an attribute of the Web control to the specified name and value.

(Inherited from WebControl)
ICallbackContainer.GetCallbackScript(IButtonControl, String) ICallbackContainer.GetCallbackScript(IButtonControl, String) ICallbackContainer.GetCallbackScript(IButtonControl, String) ICallbackContainer.GetCallbackScript(IButtonControl, String)

為執行排序作業的按鈕建立回呼指令碼。Creates the callback script for a button that performs a sorting operation.

ICallbackEventHandler.GetCallbackResult() ICallbackEventHandler.GetCallbackResult() ICallbackEventHandler.GetCallbackResult() ICallbackEventHandler.GetCallbackResult()

傳回以控制項為目標之回呼事件的結果。Returns the result of a callback event that targets a control.

ICallbackEventHandler.RaiseCallbackEvent(String) ICallbackEventHandler.RaiseCallbackEvent(String) ICallbackEventHandler.RaiseCallbackEvent(String) ICallbackEventHandler.RaiseCallbackEvent(String)

建立 GetCallbackEventReference(Control, String, String, String, Boolean) 方法中回呼處理常式的引數。Creates the arguments for the callback handler in the GetCallbackEventReference(Control, String, String, String, Boolean) method.

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

如需這個成員的說明,請參閱 GetDesignModeState()For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

如需這個成員的說明,請參閱 SetDesignModeState(IDictionary)For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

如需這個成員的說明,請參閱 SetOwnerControl(Control)For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IDataBoundControl.DataKeyNames IDataBoundControl.DataKeyNames IDataBoundControl.DataKeyNames IDataBoundControl.DataKeyNames

針對資料繫結控制項中顯示的項目,取得或設定主索引鍵欄位的名稱。Gets or sets the names of the primary key fields for the items displayed in a data-bound control.

IDataBoundControl.DataMember IDataBoundControl.DataMember IDataBoundControl.DataMember IDataBoundControl.DataMember

取得或設定資料來源控制項公開的資料表,以繫結至資料繫結控制項。Gets or sets the table that is exposed by the data source control to bind to the data-bound control.

IDataBoundControl.DataSource IDataBoundControl.DataSource IDataBoundControl.DataSource IDataBoundControl.DataSource

取得或設定資料繫結控制項從中擷取其資料項目清單的資料來源物件。Gets or sets the data source object from which the data-bound control retrieves the list of data items.

IDataBoundControl.DataSourceID IDataBoundControl.DataSourceID IDataBoundControl.DataSourceID IDataBoundControl.DataSourceID

取得或設定資料來源的識別碼,資料繫結控制項會從其中擷取資料項目清單。Gets or sets the ID of the data source from which the data-bound control retrieves the list of data items.

IDataBoundControl.DataSourceObject IDataBoundControl.DataSourceObject IDataBoundControl.DataSourceObject IDataBoundControl.DataSourceObject

取得或設定資料繫結控制項從中擷取其資料項目清單的資料來源物件。Gets or sets the data source object from which the data-bound control retrieves the list of data items.

IDataBoundListControl.ClientIDRowSuffix IDataBoundListControl.ClientIDRowSuffix IDataBoundListControl.ClientIDRowSuffix IDataBoundListControl.ClientIDRowSuffix

取得或設定資料欄位的名稱,這些值會附加至 ClientID 屬性,以便識別資料繫結控制項的每一個唯一的執行個體。Gets or sets the names of the data fields whose values are appended to the ClientID property value to uniquely identify each instance of a data-bound control.

IDataBoundListControl.DataKeys IDataBoundListControl.DataKeys IDataBoundListControl.DataKeys IDataBoundListControl.DataKeys

取得物件集合,這些物件表示資料繫結控制項中的 DataKeys 值。Gets a collection of objects that represent the DataKeys value in a data-bound control.

IDataBoundListControl.EnablePersistedSelection IDataBoundListControl.EnablePersistedSelection IDataBoundListControl.EnablePersistedSelection IDataBoundListControl.EnablePersistedSelection

取得或設定值,指出是根據索引還是資料索引鍵值來選取資料列。Gets or sets a value that indicates whether the selection of a row is based on index or on data-key values.

IDataBoundListControl.SelectedDataKey IDataBoundListControl.SelectedDataKey IDataBoundListControl.SelectedDataKey IDataBoundListControl.SelectedDataKey

取得物件,其中包含資料繫結控制項中所選取資料列的資料索引鍵值。Gets the object that contains the data key value for the selected row in a data-bound control.

IDataBoundListControl.SelectedIndex IDataBoundListControl.SelectedIndex IDataBoundListControl.SelectedIndex IDataBoundListControl.SelectedIndex

取得或設定資料繫結控制項中所選取資料列的索引。Gets or sets the index of the selected row in the data-bound control.

IDataKeysControl.ClientIDRowSuffixDataKeys IDataKeysControl.ClientIDRowSuffixDataKeys IDataKeysControl.ClientIDRowSuffixDataKeys IDataKeysControl.ClientIDRowSuffixDataKeys

取得資料值,這些值會在 ASP.NET 產生 ClientID 值時,用來識別資料繫結控制項的每個唯一的執行個體。Gets the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.

IFieldControl.FieldsGenerator IFieldControl.FieldsGenerator IFieldControl.FieldsGenerator IFieldControl.FieldsGenerator

取得或設定控制項,這個控制項會自動產生資料繫結控制項的資料行,以供 ASP.NET 動態資料使用。Gets or sets the control that automatically generates the columns for a data-bound control for use by ASP.NET Dynamic Data.

IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

如需這個成員的說明,請參閱 AddParsedSubObject(Object)For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)
IPersistedSelector.DataKey IPersistedSelector.DataKey IPersistedSelector.DataKey IPersistedSelector.DataKey

如需這個成員的說明,請參閱 DataKeyFor a description of this member, see DataKey.

IPostBackContainer.GetPostBackOptions(IButtonControl) IPostBackContainer.GetPostBackOptions(IButtonControl) IPostBackContainer.GetPostBackOptions(IButtonControl) IPostBackContainer.GetPostBackOptions(IButtonControl)

建立表示指定按鈕控制項之回傳行為的 PostBackOptions 物件。Creates a PostBackOptions object that represents the postback behavior of the specified button control.

IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String)

回傳至伺服器時引發 GridView 控制項的適當事件。Raises the appropriate events for the GridView control when it posts back to the server.

Extension Methods

EnablePersistedSelection(BaseDataBoundControl) EnablePersistedSelection(BaseDataBoundControl) EnablePersistedSelection(BaseDataBoundControl) EnablePersistedSelection(BaseDataBoundControl)

啟用要保存於資料控制項中且支援選取和分頁的選項。Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

傳回與指定之控制項的資料控制項相關聯的資料來源。Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

傳回包含資料控制項的中繼資料表物件。Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer)

取得所指定資料控制項的預設值集合。Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer)

取得所指定資料控制項中的資料表中繼資料。Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable)

設定所指定資料控制項中的資料表中繼資料。Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

設定所指定資料控制項的資料表中繼資料及預設值對應。Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object)

設定所指定資料控制項的資料表中繼資料及預設值對應。Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable)

判斷資料表中繼資料是否可供使用。Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type)

針對指定的資料控制項啟用動態資料行為。Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

針對指定的資料控制項啟用動態資料行為。Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object)

針對指定的資料控制項啟用動態資料行為。Enables Dynamic Data behavior for the specified data control.

適用於

另請參閱