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 網站專案:下載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>

如需示範如何存取儲存格中之值的範例, GridViewRow請參閱。For 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.

注意

如果您熟悉 .NET Framework 版本 1.0 DataGrid中的控制項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.

您也可以AutoGenerateColumns將屬性設定為, 然後定義您GridView自己的資料列欄位集合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. 集合會將所有資料列欄位儲存在控制項中, 並可讓您以程式設計方式管理GridView控制項中的資料列欄位。 ColumnsThe 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

System.Collections.IEnumerable ObjectDataSource SqlDataSource System.Collections.ArrayList System.Data.DataView控制項可以系結至資料來源控制項 (例如控制項或控制項), 或系結至任何可執行介面的資料來源集合, 例如、、 GridView System.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:

  • 若要系結至資料來源控制項, 請DataSourceIDGridView控制項的屬性設為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介面的資料來源, 請以程式設計方式將GridView控制項的DataSource屬性設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控制項不會提供內建的排序、更新、刪除和分頁功能。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 , 控制項可以利用資料來源控制項的功能, 並提供自動排序、更新和刪除功能。 GridViewWhen 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將屬性true設定為。To 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. AutoGenerateEditButton CommandField如果、 或AutoGenerateSelectButton屬性分別設定為,true控制項就可以自動加入具有 [編輯]、[刪除] 或 [選取] 按鈕的資料列欄位。 GridView AutoGenerateDeleteButtonThe 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將屬性true設定為。To enable paging, set the AllowPaging property to true.

注意

控制項會根據儲存在中ViewState的資訊, 在回傳時重新建立控制項。 GridViewThe GridView control is re-created on postback based on the information that is stored in ViewState. true如果控制項包含或, CommandFieldCausesValidation屬性設定為, 則屬性也必須設定為,以確保並行資料作業(例如true EnableViewState TemplateField GridView更新和刪除, 適用于適當的資料列。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 屬性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. 當屬性也設定時, 資料列會在RowStyle設定和AlternatingRowStyle設定之間交替顯示。 AlternatingRowStyleWhen 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 屬性為 disabled 時,控制項是否應該將所轉譯 HTML 項目的 false 屬性設為 "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.

擴充方法

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.

適用於

另請參閱