System.Web 2.0.0.0 System.Web.UI.WebControls.CompositeDataBoundControl System.Web.UI.ICallbackEventHandler System.Web.UI.IDataItemContainer System.Web.UI.IPostBackEventHandler System.Web.UI.WebControls.ICallbackContainer System.Web.UI.WebControls.IPostBackContainer System.ComponentModel.DefaultEvent("PageIndexChanging") System.Web.UI.ControlValueProperty("SelectedValue") System.ComponentModel.Designer("System.Web.UI.Design.WebControls.DetailsViewDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner") System.Web.UI.ToolboxData("<{0}:DetailsView runat="server" Width="125px" Height="50px"></{0}:DetailsView>") System.Web.UI.SupportsEventValidation In this topic: Introduction Row Fields Binding to Data Security Data Operations Customizing the User Interface Events Accessibility Declarative Syntax

Introduction

The control is used to display a single record from a data source in a table, where each field of the record is displayed in a row of the table. It can be used in combination with a control for master-detail scenarios. The control supports the following features: Binding to data source controls, such as . Built-in inserting capabilities. Built-in updating and deleting capabilities. Built-in paging capabilities. Programmatic access to the object model to dynamically set properties, handle events, and so on. Customizable appearance through themes and styles.

Row Fields

Each data row in the control is created by declaring a field control. Different row field types determine the behavior of the rows in the control. Field controls derive from . The following table lists the different row field types that can be used. Column field type Description Displays the value of a field in a data source as text. Displays a command button in the control. This allows you to display a row with a custom button control, such as an Add or a Remove button. Displays a check box in the control. This row field type is commonly used to display fields with a Boolean value. Displays built-in command buttons to perform edit, insert, or delete operations in the control. Displays the value of a field in a data source as a hyperlink. This row field type allows you to bind a second field to the hyperlink's URL. Displays an image in the control. Displays user-defined content for a row in the control according to a specified template. This row field type allows you to create a custom row field. By default, the property is set to true, which automatically generates a bound row field object for each field of a bindable type in the data source. Valid bindable types are , , , , and the set of primitive types. Each field is then displayed in a row as text, in the order in which each field appears in the data source. Automatically generating the rows provides a quick and easy way to display every field in the record. However, to make use of the control's advanced capabilities you must explicitly declare the row fields to include in the control. To declare the row fields, first set the property to false. Next, add opening and closing <Fields> tags between the opening and closing tags of the control. Finally, list the row fields that you want to include between the opening and closing <Fields> tags. The row fields specified are added to the collection in the order listed. The collection allows you to programmatically manage the row fields in the control. Automatically generated row fields are not added to the collection. Explicitly declared row fields can be displayed in combination with automatically generated row fields. When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields.

Binding to Data

The control can be bound to a data source control (such as the control or control) or to any data source collection that implements the interface, such as , , , or other collection types. Use one of the following methods to bind the control to the appropriate data source type: To bind to a data source control, set the property of the control to the value of the data source control. The control automatically binds to the specified data source control. This is the preferred method to bind to data. To bind to a data source that implements the interface, programmatically set the property of the control to the data source and then call the method. For more information on data binding, see
ASP.NET Data Binding.

Security

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. For more information, see
Script Exploits Overview. Validation server controls are also provided to assess user input. For more information, see Validation Server Controls.

Data Operations

The control provides built-in capabilities that allow the user to update, delete, insert, and page through items in the control. When the control is bound to a data source control, the control can take advantage of the data source control's capabilities and provide automatic updating, deleting, inserting, and paging functionality. The control can provide support for update, delete, insert, and paging operations with other types of data sources; however, you must provide the implementation for these operations in an appropriate event handler. For more information, see , , and . The control can automatically add a row field with an Edit, Delete, or New button by setting the , , or properties to true, respectively. Unlike the Delete button (which deletes the selected record immediately), when the Edit or New button is clicked, the control goes into edit or insert mode, respectively. In edit mode, the Edit button is replaced with an Update and a Cancel button. Input controls that are appropriate for the field's data type (such as a or a control) are displayed with a field's value for the user to modify. Clicking the Update button updates the record in the data source, while clicking the Cancel button abandons any changes. Likewise, in insert mode, the New button is replaced with an Insert and a Cancel button, and empty input controls are displayed for the user to enter the values for the new record. You can also manually define the update, delete, and insert command buttons in a , , or row field. The control recognizes buttons with the property set to "Edit", "Update", "Delete", "New", "Insert", or "Cancel"; however, you still must provide the functionality yourself. For more information, see , , and . The control provides a paging feature, which allows the user to navigate to other records in the data source. When enabled, page navigation controls are displayed in a pager row. To enable paging, set the property to true. The pager row can be customized using the and properties.

Customizing the User Interface

You can customize the appearance of the control by setting the style properties for different parts of the control. The following table lists the style properties that you can set. Style property Description The style settings for the alternating data rows in the control. When this property is set, the data rows are displayed in bands, alternating between the settings and the settings. The style settings for the row that contains the built-in command buttons. The style settings for the data rows when the control is in edit mode. The style settings for the empty data row that are displayed in the control when the data source does not contain any records. The style settings for the footer row. The style settings for the header row. The style settings for the data rows when the control is in insert mode. The style settings for the pager row. The style settings for the data rows in the control. When the property is also set, the data rows are displayed alternating between the settings and the settings. The style settings for the header column.

Events

The control provides several events that you can program against. This allows you to run a custom routine whenever an event occurs. The following table lists the events supported by the control. The control also inherits these events from its base classes: , , , , , , and . Event Description Occurs when a button is clicked in the control. Occurs after all objects are created in the control. This event is often used to modify the values of a record before it is displayed. Occurs when a Delete button is clicked, but after the control deletes the record from the data source. This event is often used to check the results of the delete operation. Occurs when a Delete button is clicked, but before the control deletes the record from the data source. This event is often used to cancel the delete operation. Occurs when an Insert button is clicked, but after the control inserts the record. This event is often used to check the results of the insert operation. Occurs when an Insert button is clicked, but before the control inserts the record. This event is often used to cancel the insert operation. Occurs when an Update button is clicked, but after the control updates the row. This event is often used to check the results of the update operation. Occurs when an Update button is clicked, but before the control updates the record. This event is often used to cancel the update operation. Occurs after the control changes modes (edit, insert, or read-only mode). This event is often used to perform a task when the control changes modes. Occurs before the control changes modes (edit, insert, or read-only mode). This event is often used to cancel a mode change. Occurs when one of the pager buttons is clicked, but after the control handles the paging operation. This event is commonly used when you need to perform a task after the user navigates to a different record in the control. Occurs when one of the pager buttons is clicked, but before the control handles the paging operation. This event is often used to cancel the paging operation.

Accessibility

For information about how to configure this control so that it generates markup that conforms to accessibility standards, see
Accessibility in Visual Studio 2010 and ASP.NET 4 and ASP.NET Controls and Accessibility.

Declarative Syntax

<asp:DetailsView     AccessKey="string"     AllowPaging="True|False"     AutoGenerateDeleteButton="True|False"     AutoGenerateEditButton="True|False"     AutoGenerateInsertButton="True|False"     AutoGenerateRows="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"     DefaultMode="ReadOnly|Edit|Insert"     EmptyDataText="string"     Enabled="True|False"     EnablePagingCallbacks="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"     FooterText="string"     ForeColor="color name|#dddddd"     GridLines="None|Horizontal|Vertical|Both"     HeaderText="string"     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"     OnItemCommand="ItemCommand event handler"     OnItemCreated="ItemCreated event handler"     OnItemDeleted="ItemDeleted event handler"     OnItemDeleting="ItemDeleting event handler"     OnItemInserted="ItemInserted event handler"     OnItemInserting="ItemInserting event handler"     OnItemUpdated="ItemUpdated event handler"     OnItemUpdating="ItemUpdating event handler"     OnLoad="Load event handler"     OnModeChanged="ModeChanged event handler"     OnModeChanging="ModeChanging event handler"     OnPageIndexChanged="PageIndexChanged event handler"     OnPageIndexChanging="PageIndexChanging event handler"     OnPreRender="PreRender 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"     runat="server"     SkinID="string"     Style="string"     TabIndex="integer"     ToolTip="string"     Visible="True|False"     Width="size" >         <AlternatingRowStyle />         <CommandRowStyle />         <EditRowStyle />         <EmptyDataRowStyle />         <EmptyDataTemplate> <!-- child controls -->         </EmptyDataTemplate>         <FieldHeaderStyle />         <Fields>                 <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>         </Fields>         <FooterStyle />         <FooterTemplate> <!-- child controls -->         </FooterTemplate>         <HeaderStyle />         <HeaderTemplate> <!-- child controls -->         </HeaderTemplate>         <InsertRowStyle />         <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        /> </asp:DetailsView>
Displays the values of a single record from a data source in a table, where each data row represents a field of the record. The control allows you to edit, delete, and insert records.
Constructor Use this constructor to initialize a new instance of the class. To dynamically add a control to a page, create a new object, set its properties, and then add it to the collection of a container control, such as . Initializes a new instance of the class. 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. The control has built-in paging capabilities, which allow a user to navigate to a different record in the data source. The control can perform both user interface (UI) and data source paging. The UI paging feature can be used with any data source object that supports the interface. For each paging operation, the control queries the data source for the entire data collection and selects the row to display, essentially discarding the remaining data. If a data source implements and the property returns true, the control will use data source paging instead of UI paging. In this case, the control will query for only the row needed for each paging operation. Thus, data source paging is more efficient than UI paging. Only the object supports data source paging without modification. To enable the paging feature, set the property to true. You can determine the total number of items in the underlying data source by using the property. To determine the index of the currently displayed item, use the property. When paging is enabled, an additional row called the pager row is automatically displayed in the control. The pager row contains the page navigation controls and can be displayed at the top, bottom, or both the top and bottom of the control. The pager row has two built-in pager display modes: numbered pages and next and previous page links (default). The numbered pages mode displays links for the individual pages, allowing the user to navigate to a specific page. The next and previous links mode displays controls that allow the user to navigate to the next or the previous page. The control automatically hides the pager row when the data source contains fewer than two records. You can control the settings of the pager row (such as the pager display mode, the number of page links to display at a time, and the pager control's text label) by using the property. To control the appearance of the pager row (including its background color, font color, and position), use the property. The control also allows you to define a custom template for the pager row. For more information on creating a custom pager row template, see . The control provides several events that you can use to perform a custom action when paging occurs. The following table lists the available events. Event Description Occurs when one of the pager buttons is clicked, but after the control handles the paging operation. This event is commonly used when you need to perform a task after the user navigates to a different record in the control. Occurs when one of the pager buttons is clicked, but before the control handles the paging operation. This event is often used to cancel the paging operation. The value of is stored in view state. Gets or sets a value indicating whether the paging feature is enabled. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of alternating data rows in a control. When this property is set, the data rows are displayed alternating between the settings and the settings. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, AlternatingRowStyle-ForeColor). The properties can also be set programmatically in the form (for example, AlternatingRowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the alternating data rows in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. When a control is bound to an object that inherits from and the property returns true, the control can take advantage of the data source control's capabilities and provide automatic deleting functionality. For a object to delete data, the property of the underlying object must be set with a delete query statement. When the property is set to true, a row field with a Delete button is automatically displayed in the control. Clicking the Delete button permanently removes that record from the data source. You must also set the property for the automatic deletion feature to work. The control provides several events that you can use to perform a custom action when a record is deleted. The following table lists the available events. Event Description Occurs when the Delete button is clicked, but after the control deletes the record from the data source. This event is often used to check the results of the delete operation. Occurs when the Delete button is clicked, but before the control deletes the record from the data source. This event is often used to cancel the delete operation. The value of is stored in view state. Gets or sets a value indicating whether the built-in control to delete the current record is displayed in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. When a data source control that supports updating is bound to a control, the control can take advantage of the data source control's capabilities and provide automatic updating functionality. For a data source control to update data, its property must be set with an update query statement. When the property is set to true, a row field with an Edit button is automatically displayed in the control. Clicking the Edit button puts that control in edit mode. When in edit mode, each bound field in the control that is not read-only displays the appropriate input control, such as a control, for the field's data type. This allows the user to modify the field's value. When clicked, the Edit button is also replaced with an Update button and a Cancel button. Clicking the Update button updates the record in the data source with any value changes and returns the control to the mode specified by the property. Clicking the Cancel button abandons any value changes and returns the control to the default mode. To put a control in edit mode programmatically, use the method. When the property is also set to true, the control automatically ensures that the field or fields specified in the property are read-only. Unless you implement your own updating functionality, you must set the property for the automatic updating feature to work. You can control the appearance of the data rows when the control is in edit mode by using the property. Common settings usually include a custom background color, foreground color, and font properties. The control provides several events that you can use to perform a custom action when a record is updated. The following table lists the available events. Event Description Occurs when the Update button is clicked, but after the control updates the record. This event is often used to check the results of the update operation. Occurs when the Update button is clicked, but before the control updates the record. This event is often used to cancel the update operation. Occurs after the control changes modes. Occurs before the control changes modes. This event is often used to cancel the mode change. The value of is stored in view state. Gets or sets a value indicating whether the built-in controls to edit the current record are displayed in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. When a data source control that supports inserting is bound to a control, the control can take advantage of the data source control's capabilities and provide automatic inserting functionality. For a data source control to insert data, its property must be set with an insert query statement. When the property is set to true, a row field with a New button is automatically displayed in the control. Clicking the New button puts that control in insert mode. When in insert mode, each bound field in the control that is not read-only displays the appropriate input control, such as a control, for the field's data type. This allows the user to enter the field's value for the new record. When clicked, the New button is also replaced with an Insert button and a Cancel button. Clicking the Insert button inserts the new record in the data source and returns the control to the mode specified by the property. Clicking the Cancel button abandons the insert operation and returns the control to the default mode. To put a row in insert mode programmatically, use the method. You can control the appearance of a record that is in insert mode by using the property. Common settings usually include a custom background color, foreground color, and font properties. The control provides several events that you can use to perform a custom action when a new record is inserted. The following table lists the available events. Event Description Occurs when the Insert button is clicked, but after the control inserts the record. This event is often used to check the results of the insert operation. Occurs when the Insert button is clicked, but before the control inserts the record. This event is often used to cancel the insert operation. Occurs after the control changes modes. Occurs before the control changes modes. This event is often used to cancel the mode change. The value of is stored in view state. Gets or sets a value indicating whether the built-in controls to insert a new record are displayed in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(true) System.Boolean To be added. Each data row in the control is represented by a row field. When the property is set to true, an automatically generated bound row field is created for each field in the data source. Each field is then displayed in a row as text, in the order in which each field appears in the data source. Automatically generated bound row fields are not added to the collection. Automatically generating the rows provides a quick and easy way to display every field in the record. However, to make use of the control's advanced capabilities you must explicitly declare the row fields to include in the control. For more information, see . Explicitly declared row fields can be used in combination with automatically generated row fields. When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields. The value of is stored in view state. Gets or sets a value indicating whether row fields for each field in the data source are automatically generated and displayed in a control. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. Use the property to specify the URL to an image to display in the background of a control. If the specified image is smaller than the control, the image is tiled to fill in the background. If the image is larger than the control, the image is cropped. Gets or sets the URL to an image to display in the background of a control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.DetailsViewRow To be added. When paging is enabled (by setting the property to true), an additional row called the pager row is automatically displayed in the control. The pager row contains controls that allow the user to navigate to other records, and can be displayed at the top, the bottom, or both the top and bottom of the control. Use the property to programmatically access the object that represents the bottom pager row in the control. The property is available only after the control creates the bottom pager row in the event. This property is commonly used when you need to programmatically manipulate the bottom pager row, for example when adding custom content. Any modification to the property must be performed after the control has been rendered; otherwise, the control will overwrite any changes. Gets a object that represents the bottom pager row in a control. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.ComponentModel.DefaultValue("") System.String To be added. Use the property to specify the text to render in an HTML caption element in a control. The text that you specify provides assistive technology devices with a description of the table that can be used to make the control more accessible. Additional accessibility support for the control is provided by the property. Use the property to specify the alignment of the HTML caption element in a control. The value of is stored in view state. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text to render in an HTML caption element in a control. This property is provided to make the control more accessible to users of assistive technology devices. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.TableCaptionAlign.NotSet) System.Web.UI.WebControls.TableCaptionAlign To be added. Use the property to specify the horizontal or vertical position of the HTML caption element in a control. This property is provided to make the control more accessible to users of assistive technology devices. This property is set using one of the enumeration values. The following table lists the possible values. Value Description TableCaptionAlign.Bottom The caption element is aligned with the bottom of the table. TableCaptionAlign.Left The caption element is aligned with the left side of the table. TableCaptionAlign.NotSet The caption element's alignment is not set. TableCaptionAlign.Right The caption element is aligned with the right side of the table. TableCaptionAlign.Top The caption element is aligned with the top of the table. Additional accessibility support for the control is provided by the property. Use the property to specify the text to render in an HTML caption element in a control. The value of is stored in view state. Gets or sets the horizontal or vertical position of the HTML caption element in a control. This property is provided to make the control more accessible to users of assistive technology devices. 2.0.0.0 Property System.ComponentModel.DefaultValue(-1) System.Int32 To be added. Use the property to control the spacing between the contents of a cell and the cell's border. The padding amount specified is added to all four sides of the cell. All cells in the same column of a control have the same width. The padding amount is applied to the widest cell and all other cells in the column are adjusted to that cell width. Similarly, all cells in the same row have the same height. The padding amount is applied to the tallest cell in the row and all other cells in the row are adjusted to that cell height. Individual cell sizes cannot be specified. To adjust the spacing between cells, use the property. Gets or sets the amount of space between the contents of a cell and the cell's border. 2.0.0.0 Property System.ComponentModel.DefaultValue(0) System.Int32 To be added. Use the property to control the spacing between adjacent cells in the control. This spacing is applied both vertically and horizontally. The cell spacing is uniform for the entire control. Individual cell spacing between rows or columns cannot be specified. If you set this property to a value greater than 0, and then set the property to a value that displays the cell borders, a gap is displayed between the borders of adjacent cells. In this situation, the property controls the size of the gap. To adjust the spacing between the contents of a cell and the cell's border, use the property. Gets or sets the amount of space between cells. 2.0.0.0 Method System.Void Use the method to programmatically switch the control between edit, insert, and read-only mode. This method also updates the property with the specified mode. The following table lists the different mode values. Mode Description DetailsViewMode.Edit The control is in edit mode, which allows the user to update the values of a record. DetailsViewMode.Insert The control is in insert mode, which allows the user to add a new record to the data source. DetailsView.ReadOnly The control is in read-only mode, which is the normal display mode. Switches the control to the specified mode. One of the values. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of a command row in a control. A command row contains the command buttons to perform operations such as editing, deleting, and inserting. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, CommandRowStyle-ForeColor). The properties can also be set programmatically in the form (for example, CommandRowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of a command row in a control. 2.0.0.0 Method System.Web.UI.WebControls.AutoGeneratedField The method is a helper method called by the control to create an automatically generated row field using the specified field properties. Creates an object that represents an automatically generated row field using the specified field properties. An that contains the field properties specified by the parameter. An that contains the properties for the . 2.0.0.0 Method System.Collections.ICollection When the property is set to true, the method is called by the control to create a set of automatically generated row fields for the current data item. Creates a set of automatically generated row fields for the specified data item. An that contains the automatically generated row fields for the specified data item. The data item for which to create the automatically generated row fields. 2.0.0.0 Method System.Int32 To be added. The method is a helper method called by the control to create the control hierarchy for the control. Creates the control hierarchy used to render the control. The number of items in the data source. true to indicate that this method is being called during data binding; otherwise, false. 2.0.0.0 Method System.Web.UI.WebControls.Style The method is a helper method called by the control to create its default table style object. In addition to the default style setting of a object, this method also sets the properties in the following table. Property Initial value GridLines.Both 0 Creates a default table style object for the control. A that contains the default table style for the control. 2.0.0.0 Method System.Web.UI.DataSourceSelectArguments The method is a helper method called by the control to create the object that gets passed to the Select command. Creates the object that gets passed to the Select command. The that gets passed to the Select command 2.0.0.0 Method System.Collections.ICollection The method is a helper method called by the control to create the complete set of row fields for the control. If the property is set to true, automatically generated row fields are appended to the user-defined row fields contained in the collection. To create the automatically generated row fields based on the data item, pass in true for the parameter; otherwise, the automatically generated row fields are created based on properties of the existing row fields in the control. Creates the complete set of automatically generated and user-defined row fields used to generate the control hierarchy. An that contains both the automatically generated and the user-defined row fields for the specified data item. The data item for which to create the row fields. true to use the data item to create the automatically generated row fields; otherwise, false. 2.0.0.0 Method System.Web.UI.WebControls.DetailsViewRow The method is a helper method called by the control to create a object. Creates a object using the specified item index, row type, and row state. A with the specified item index, row type, and row state. The zero-based index of the data item to display. One of the values. One of the values. 2.0.0.0 Method System.Web.UI.WebControls.Table The method is a helper method called by the control to create a table that acts as the container for the control. Creates the containing table for the control. A that represents the containing table for the control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.DetailsViewMode To be added. Use the property to determine whether the control is in edit, insert, or read-only mode. The following table lists the different mode values. Mode Description DetailsViewMode.Edit The control is in edit mode, which allows the user to update the values of a record. DetailsViewMode.Insert The control is in insert mode, which allows the user to add a new record to the data source. DetailsViewMode.ReadOnly The control is in read-only mode, which is the normal display mode. This value is normally set automatically by the control by when the New, Update, Insert, Delete, or Cancel command button is clicked. You can also programmatically change the mode by using the method. When the control changes modes, the events in the following table are raised. This allows you to create a custom event handler that performs a routine when the event occurs. Event Description Occurs when a command button that changes the mode of the control is clicked, but after the mode changes. Occurs when a command button that changes the mode of the control is clicked, but before the mode changes. Gets the current data-entry mode of the control. 2.0.0.0 Method System.Void Data-bound controls should override instead of . Calls the method of the base class. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Object To be added. Use the property to access the data item bound to the control. The data item is often used to access the field values of the current record directly. The type of the returned by this property varies depending on the data source. For example, when a control is bound to the control, a object is returned. This property is available only after data binding has occurred. Before data binding occurs, this property returns null. This property is also not applicable when the control is in insert mode and returns null. Gets the data item bound to the control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Int32 To be added. When the paging feature is enabled (by setting the property to true), use the property to determine the total number of records in the underlying data source. Because the control displays only one record at a time, this value also corresponds to the total number of pages required to display every record in the data source. To determine the index of the current record from the underlying data source, use the property. Gets the number of items in the underlying data source. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Int32 To be added. When the paging feature is enabled (by setting the property to true), use the property to determine the index of the currently displayed record. You can also use this property to programmatically change the displayed record. When the paging feature is enabled, you can also use this property to determine the page number of the record displayed; however, be aware that this property is zero-based. To determine the total number of items in the data source, use the property. Gets the index of the item being displayed in a control from the underlying data source. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.ComponentModel.Browsable(false) System.Web.UI.WebControls.DataKey To be added. When the property is set, the control automatically creates a object that represents the key field or fields for the current record. Use the property to get this object. This property is commonly used to obtain the keys and their corresponding values for the fields specified in the property. As a shortcut, you can also use the property to determine the value of the first key field listed in the property. Gets a object that represents the primary key of the displayed record. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.WebControls.DataFieldEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.StringArrayConverter)) System.ComponentModel.DefaultValue(null) System.String[] To be added. Use the property to specify a comma-separated list of field names that represent the primary key of the data source. When the property is set, the control automatically creates a object that represents the key field or fields for the current record and stores it in the property. When the property is also set to true, the control automatically ensures that the field or fields specified in the property are read-only. You must set the property for the automatic updating, deleting, and inserting features of the control to work. If the property of a row field is set to false, the row is not displayed in the control and the data for the row does not make a round trip to the client. If you want the data for a row that is not visible to make a round trip, add the field name to the property. Gets or sets an array that contains the names of the key fields for the data source. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.DetailsViewMode.ReadOnly) System.Web.UI.WebControls.DetailsViewMode To be added. Use the property to specify whether the control returns to edit, insert, or read-only mode after an edit or insert operation is performed. By default, the control returns to read-only mode; however, you can keep the control in edit or insert mode by setting this property to the appropriate value. The following table lists the different mode values. Mode Description DetailsViewMode.Edit The control is in edit mode, which allows the user to update the values of a record. DetailsViewMode.Insert The control is in insert mode, which allows the user to add a new record to the data source. DetailsViewMode.ReadOnly The control is in read-only mode, which is the normal display mode. Get or sets the default data-entry mode of the control. 2.0.0.0 Method System.Void The deletion does not occur if the control is in Insert mode. The event is raised immediately before the item is deleted. Set the property to true to cancel the deletion. Deletes the current record from the data source. 2.0.0.0 Property System.ComponentModel.DefaultValue(null) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of the data rows when a control is in edit mode. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, EditRowStyle-ForeColor). The properties can also be set programmatically in the form (for example, EditRowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the data rows when a control is in edit mode. 2.0.0.0 Property System.ComponentModel.DefaultValue(null) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of the empty data row in a control. The empty data row is displayed when the data source that is bound to the control does not contain any records. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, EmptyDataRowStyle-ForeColor). The properties can also be set programmatically in the form (for example, EmptyDataRowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the empty data row displayed when the data source bound to a control does not contain any records. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.DetailsView), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. The empty data row is displayed in a control when the data source that is bound to the control does not contain any records. You can define your own custom user interface (UI) for the empty data row by using the property. To specify a custom template for the null row, first place <EmptyDataTemplate> tags between the opening and closing tags of the control. You can then list the contents of the template between the opening and closing <EmptyDataTemplate> tags. To control the style of the empty data row, use the property. Alternatively, you can use the built-in UI for the empty data row by setting the property instead of this property. If both the and properties are set, the property takes precedence. Gets or sets the user-defined content for the empty data row rendered when a control is bound to a data source that does not contain any records. 2.0.0.0 Property System.ComponentModel.DefaultValue("") System.ComponentModel.Localizable(true) System.String To be added. The empty data row is displayed in a control when the data source that is bound to the control does not contain any records. Use the property to specify the text to display in the empty data row. To control the style of the empty data row, use the property. Alternatively, you can define your own custom user interface (UI) for the empty data row by setting the property instead of this property. If both the and properties are set, the property takes precedence. The value of is stored in view state. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text to display in the empty data row rendered when a control is bound to a data source that does not contain any records. 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. Use the property to specify whether paging operations are performed using client-side callback functions. When enabled, paging is performed using the callback feature, which prevents the need to post the page back to the server. The client-side paging feature is only supported in Microsoft Internet Explorer 5.5 and later and Netscape 6.0 and later. The value of is stored in view state. Gets or sets a value indicating whether client-side callback functions are used for paging operations in the control. 2.0.0.0 Method System.Void The data binding does not occur if the control is in Insert mode. Calls the method after verifying that the data listing control requires data binding and that a valid data source control is specified. 2.0.0.0 Method System.Void To be added. The method is a helper method called by the control to retrieve the values of each field. The values can them be used for data source operations. You can specify whether the extracted values include read-only fields and key fields by using the and parameters, respectively. Retrieves the values of each field displayed and stores them in the specified object. An used to store the field values. true to include read-only fields; otherwise, false. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of the field header column in a control. This is the column that contains the field names of the data values. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, FieldHeaderStyle-ForeColor). The properties can also be set programmatically in the form (for example, FieldHeaderStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the header column in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(null) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.MergableProperty(false) System.ComponentModel.Editor("System.Web.UI.Design.WebControls.DataControlFieldTypeEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.Web.UI.WebControls.DataControlFieldCollection To be added. When you explicitly declare the row fields for a control, these row fields are stored in the property (collection). The collection also allows you to programmatically manage the collection of explicitly declared rows. Explicitly declared row fields can be used in combination with automatically generated row fields. When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields. Automatically generated row fields are not added to the collection. Different row field types determine the behavior of the rows in the control. The following table shows the different row field types that can be used in the collection. Row field type Description Displays the value of a field in a data source as text. Displays a command button in the control. This allows you to display a row with a custom button control, such as an Add or a Remove button. Displays a check box in the control. This row field type is commonly used to display fields with a Boolean value. Displays built-in command buttons to perform edit, insert, or delete operations in the control. Displays the value of a field in a data source as a hyperlink. This row field type allows you to bind a second field to the hyperlink's URL. Displays an image in the control. Displays user-defined content for a row in the control according to a specified template. This row field type allows you to create a custom row field. To explicitly declare the row fields for a control, first set the property to false. Next, add opening and closing <Fields> tags between the opening and closing tags of the control. Finally, list the row fields that you want to include between the opening and closing <Fields> tags. The row fields are displayed in the control in the order that the row fields appear in the collection. Although you can programmatically add row fields to the collection, it is easier to list the row fields declaratively in the control and then use the property of each row field to show or hide the row field. If the property of a row field is set to false, the row is not displayed in the control and the data for the row does not make a round trip to the client. If you want the data for a row that is not visible to make a round trip, add the field name to the property. Gets a collection of objects that represent the explicitly declared row fields in a control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.DetailsViewRow To be added. The footer row is displayed at the bottom of the control when the or property is set. Use the property to programmatically access the object that represents the footer row. The property is available only after the control creates the footer row in the event. This property is commonly used when you need to programmatically manipulate the footer row, for example when adding custom content. Any modification to the property must be performed after the control has been rendered; otherwise, the control will overwrite any changes. To control the style of the footer row, use the property. Gets a object that represents the footer row in a control. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. The footer row is displayed at the bottom of the control when the or property is set. Use the property to control the appearance of the footer row in a control. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, FooterStyle-ForeColor). The properties can also be set programmatically in the form (for example, FooterStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the footer row in a control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.DetailsView), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. The footer row is displayed at the bottom of the control when the or property is set. You can define your own custom user interface (UI) for the footer row by using the property. To specify a custom template for the footer row, first place <FooterTemplate> tags between the opening and closing tags of the control. You can then list the contents of the template between the opening and closing <FooterTemplate> tags. To control the style of the footer row, use the property. Alternatively, you can simply display text in the footer row by setting the property instead of this property. If both the and properties are set, the property takes precedence. Gets or sets the user-defined content for the footer row in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue("") System.ComponentModel.Localizable(true) System.String To be added. The footer row is displayed at the bottom of the control when the or property is set. Use the property to specify the text to display in the footer row. To control the style of the footer row, use the property. Alternatively, you can define your own custom user interface (UI) for the footer row by setting the property instead of this property. If both the and properties are set, the property takes precedence. The value of is stored in view state. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text to display in the footer row of a control. 2.0.0.0 Method System.String The control implements the interface and uses the to retrieve data and the method to return the retrieved data to the control. Returns the result of a callback event that targets a control. The results of the callback. 2.0.0.0 Method System.String To be added. Returns the callback string created using the specified argument. The complete callback string to be sent to the client. The control that initiated the callback. The callback code. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.GridLines.Both) System.Web.UI.WebControls.GridLines To be added. Use the property to specify the gridline style for a control. The following table lists the available styles. Style Description GridLines.None No gridlines are displayed. GridLines.Horizontal Displays the horizontal gridlines only. GridLines.Vertical Displays the vertical gridlines only. GridLines.Both Displays both the horizontal and vertical gridlines. Gets or sets the gridline style for a control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.DetailsViewRow To be added. The header row is displayed at the top of the control when the or property is set. Use the property to programmatically access the object that represents the header row. The property is available only after the control creates the header row in the event. This property is commonly used when you need to programmatically manipulate the header row, for example when adding custom content. Any modification to the property must be performed after the control has been rendered; otherwise, the control will overwrite any changes. Gets a object that represents the header row in a control. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. The header row is displayed at the top of the control when the or property is set. Use the property to control the appearance of the header row in a control. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, HeaderStyle-ForeColor). The properties can also be set programmatically in the form (for example, HeaderStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the header row in a control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.DetailsView), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. The header row is displayed at the top of the control when the or property is set. You can define your own custom user interface (UI) for the header row by using the property. To specify a custom template for the header row, first place <HeaderTemplate> tags between the opening and closing tags of the control. You can then list the contents of the template between the opening and closing <HeaderTemplate> tags. To control the style of the header row, use the property. Alternatively, you can simply display text in the header row by setting the property instead of this property. If both the and properties are set, the property takes precedence. Gets or sets the user-defined content for the header row in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue("") System.ComponentModel.Localizable(true) System.String To be added. The header row is displayed at the top of the control when the or property is set. Use the property to specify the text to display in the header row. To control the style of the header row, use the property. Alternatively, you can define your own custom user interface (UI) for the header row by setting the property instead of this property. If both the and properties are set, the property takes precedence. The value of is stored in view state. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text to display in the header row of a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.HorizontalAlign.NotSet) System.ComponentModel.Category("Layout") System.Web.UI.WebControls.HorizontalAlign To be added. Use the property to specify the horizontal alignment of a control within the page. The following table lists the different horizontal alignment styles. HorizontalAlign value Description HorizontalAlign.NotSet The horizontal alignment of the control has not been set. HorizontalAlign.Left The control is left-aligned on the page. HorizontalAlign.Center The control is centered on the page. HorizontalAlign.Right The control is right-aligned on the page. HorizontalAlign.Justify The control is aligned with both the left and right margins of the page. Gets or sets the horizontal alignment of a control on the page. 2.0.0.0 Method System.Void To be added. The method is a helper method called by the control to create the pager row. It creates a object that contains the navigation controls using the properties of the object contained in the parameter. The cell is then added to the row specified by the parameter. Creates the pager row for the control. The that contains the pager row. 2.0.0.0 Method System.Void The method is a helper method called by the control to initialize the specified object. The row is initialized for the object contained in the parameter. Initializes the specified object. The to initialize. The that corresponds to the row. 2.0.0.0 Method System.Void When the control is in insert mode, use the method to programmatically insert the current record in the data source. This method is commonly used when you need to insert the current record from outside of the control, such as from a different control on the page. The control must be in insert mode when this method is called; otherwise, an exception is thrown. To specify whether page validation is performed before the insert operation, use the parameter. Calling this method also raises the and events. Inserts the current record in the data source. true to perform page validation when the method is called; otherwise, false. 2.0.0.0 Property System.ComponentModel.DefaultValue(null) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. The data rows in the control are displayed using this style when the control is in insert mode. Use the property to control the appearance of the data rows in insert mode. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, InsertRowStyle-ForeColor). The properties can also be set programmatically in the form (for example, InsertRowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the data rows in a control when the control is in insert mode. 2.0.0.0 Method System.Boolean The method is a helper method called by the control to determine whether the specified data type can be bound to a field in the control. The control supports the following data types: All primitive data types, such as , , and Determines whether the specified data type can be bound to a field in the control. true if the specified data type can be bound to a field in the control; otherwise, false. A that represents the data type to check. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewCommandEventHandler The event is raised when a button within the control is clicked. This allows you to provide an event handler that performs a custom routine whenever this event occurs. A object is passed to the event handler, which allows you to determine the command name and command argument of the button clicked. To determine the index of the current record, use the property. For more information about handling events, see Consuming Events. Occurs when a button within a control is clicked. 2.0.0.0 Event System.EventHandler The event is raised each time a record is created in a control. This can occur when the control is first rendered, or when the user navigates to another record. You can use this event to provide an event handler that performs a custom routine, such as adding custom content to a row, whenever this event occurs. You can access the header, footer, and pager rows in the control by using the , , , or properties, respectively. To access one of the data rows, use the collection. For more information about handling events, see Consuming Events. Occurs when a record is created in a control. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewDeletedEventHandler The event is raised when a Delete button within the control is clicked, but after the delete operation. This allows you to provide an event handler that performs a custom routine, such as checking the results of the delete operation, whenever this event occurs. A object is passed to the event handler, which allows you to determine the number of rows affected and any exceptions that might have occurred. You can also indicate whether the exception was handled in the event handler by setting the property. For more information about handling events, see Consuming Events. Occurs when a Delete button within a control is clicked, but after the delete operation. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewDeleteEventHandler The event is raised when a Delete button within the control is clicked, but before the delete operation. This allows you to provide an event handler that performs a custom routine, such as canceling the delete operation, whenever this event occurs. A object is passed to the event handler, which allows you to determine the index of the record being deleted and to indicate that the delete operation should be canceled. To cancel the delete operation, set the property to true. You can also manipulate the and collections, if necessary, before the values are passed to the data source. For more information about handling events, see Consuming Events. Occurs when a Delete button within a control is clicked, but before the delete operation. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewInsertedEventHandler The event is raised when an Insert button within the control is clicked, but after the insert operation. This allows you to provide an event handler that performs a custom routine, such as checking the results of the insert operation, whenever this event occurs. A object is passed to the event handler, which allows you to determine the number of rows affected and any exceptions that might have occurred. You can also indicate whether the exception was handled in the event handler by setting the property. To keep the control in insert mode after an insert operation, set the property to true. For more information about handling events, see Consuming Events. Occurs when an Insert button within a control is clicked, but after the insert operation. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewInsertEventHandler The event is raised when an Insert button within a control is clicked, but before the insert operation. This allows you to provide an event handler that performs a custom routine, such as canceling the insert operation, whenever this event occurs. A object is passed to the event handler, which allows you to indicate that the insert operation should be canceled. To cancel the insert operation, set the property to true. You can also manipulate the collection, if necessary, before the values are passed to the data source. For more information about handling events, see Consuming Events. Occurs when an Insert button within a control is clicked, but before the insert operation. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewUpdatedEventHandler The event is raised when an Update button within the control is clicked, but after the update operation. This allows you to provide an event handler that performs a custom routine, such as checking the results of the update operation, whenever this event occurs. A object is passed to the event handler, which allows you to determine the number of rows affected and any exceptions that might have occurred. You can also indicate whether the exception was handled in the event handler by setting the property. To keep the control in edit mode after an update operation, set the property to true. For more information about handling events, see Consuming Events. Occurs when an Update button within a control is clicked, but after the update operation. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewUpdateEventHandler The event is raised when an Update button within a control is clicked, but before the update operation. This allows you to provide an event handler that performs a custom routine, such as canceling the update operation, whenever this event occurs. A object is passed to the event handler, which allows you to determine the index of the record being updated and to indicate that the update operation should be canceled. To cancel the update operation, set the property to true. You can also manipulate the , , and collections, if necessary, before the values are passed to the data source. A common way to use these collections is to HTML-encode the values supplied by the user before they are stored in the data source. This helps to prevent script injection attacks. For more information about handling events, see Consuming Events. Occurs when an Update button within a control is clicked, but before the update operation. 2.0.0.0 Method 2.0.0.0 System.Void To be added. The method is used to load the state of the properties in the control that need to be persisted, even when the property is set to false. This method is used primarily by control developers when extending the control. Loads the state of the properties in the control that need to be persisted, even when the property is set to false. Method System.Void This method is used primarily by the .NET Framework infrastructure and is not intended to be used directly from your code. However, control developers can override this method to specify how a custom server control restores its view state. For more information, see ASP.NET State Management Overview. The method is used to load the previously saved view state of the control. Loads the previously saved view state of the control. An that represents the state of the control. 2.0.0.0 Event System.EventHandler The event is raised when a control attempts to change between edit, insert, and read-only mode, but after the property is updated. This allows you to provide an event handler that performs a custom routine, such as synchronizing the control with another control, whenever this event occurs. For more information about handling events, see Consuming Events. Occurs when a control attempts to change between edit, insert, and read-only mode, but after the property is updated. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewModeEventHandler The event is raised when a control attempts to change between edit, insert, and read-only mode, but before the property is updated. This allows you to provide an event handler that performs a custom routine, such as canceling the mode change, whenever this event occurs. A object is passed to the event handler, which allows you to determine the new mode, to determine whether the mode change was a result of the user canceling an edit operation, or to cancel the mode change. To determine the new mode, use the property. To determine whether the mode change was a result of the user canceling an edit operation, use the property. You can cancel the mode change by setting the property to true. For more information about handling events, see Consuming Events. Occurs when a control attempts to change between edit, insert, and read-only mode, but before the property is updated. 2.0.0.0 Method System.Boolean The method implements the method to pass events from child controls to the page hierarchy. Determines whether the event for the Web server control is passed up the page's user interface (UI) server control hierarchy. true if the event has been canceled; otherwise, false. The source of the event. An that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. The source of the event. An that contains the event data. 2.0.0.0 Method 2.0.0.0 System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. An that contains the event data. Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. An that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. An that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. An that contains the event data. 2.0.0.0 Method System.Void The method is called by the control to raise the event. It is generally used by control developers when extending the class. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A that contains the event data. 2.0.0.0 Method System.Void The method is used to control when data binding occurs within the life cycle of the page. It does this by setting the internal initialized state of the data-bound control. Because the control's initialized state is set during the phase of the page's life cycle, the event handler is called any time a data property of the control is changed after that phase, to signal that the control must re-bind to its data before rendering. The method is overridden by the class to set the property to true in cases where the HTTP request is a postback and view state is enabled but the data-bound control has not yet been bound. This scenario is common with controls such as and , where the visibility of the control is changed at run time. Sets the initialized state of the data-bound control before the control is loaded. The that raised the event. An that contains the event data. 2.0.0.0 Method 2.0.0.0 System.Void This method notifies the server control to perform any necessary prerendering steps prior to saving view state and rendering content .It is generally used by control developers when extending the class. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. An that contains the event data. Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.ComponentModel.Browsable(false) System.Int32 To be added. If the property is null, 0 is returned. Gets the number of records in the data source. 2.0.0.0 Property System.ComponentModel.DefaultValue(0) System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.OneWay) System.Int32 To be added. When the paging feature is enabled (when the property is set to true), use the property to determine the index of the currently displayed record. You can also use this property to programmatically change the displayed record. When the paging feature is enabled, you can also use this property to determine the page number of the record displayed; however, be aware that this property is zero-based. To determine the total number of items in the data source, use the property. Gets or sets the index of the displayed record. 2.0.0.0 Event System.EventHandler The control raises the event when a pager button (a button with its CommandName property set to "Page") within the control is clicked, but after the control handles the paging operation. This allows you to provide an event handler that performs a custom routine whenever this event occurs. This event is not raised when you programmatically set the property. Pager buttons are usually located in the pager row of a control. This event is often used to synchronize a control with a control or to set the behavior of the control after a paging operation. For more information about handling events, see Consuming Events. Occurs when the value of the property changes after a paging operation. 2.0.0.0 Event System.Web.UI.WebControls.DetailsViewPageEventHandler The control raises the event when a pager button (a button with its CommandName property set to "Page") within the control is clicked, but before the control handles the paging operation. This allows you to provide an event handler that performs a custom routine, such as canceling the paging operation, whenever this event occurs. This event is not raised when you programmatically set the property. Pager buttons are usually located in the pager row of a control. A object is passed to the event handler, which allows you to determine the index of the page selected by the user and to indicate that the paging operation should be canceled. To determine the index of the page selected by the user, use the property. To cancel the paging operation, set the property of the object to true. For more information about handling events, see Consuming Events. Occurs when the value of the property changes before a paging operation. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.Web.UI.WebControls.PagerSettings To be added. Use the property to control the settings of the pager row in a control. The pager row is displayed when the paging feature is enabled (by setting the property to true) and contains the controls that allow the user to navigate to the different records in the control. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, PagerSetting-Mode). The properties can also be set programmatically in the form (for example, PagerSetting.Mode). Common settings usually include the pager row's display mode and custom text or images for the navigation controls. Gets a reference to the object that allows you to set the properties of the pager buttons in a control. 2.0.0.0 Property System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of the pager row in a control. The pager row is displayed when the paging feature is enabled (by setting the property to true) and contains the controls that allow the user to navigate to the different pages in the control. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, PagerStyle-ForeColor). The properties can also be set programmatically in the form (for example, PagerStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the pager row in a control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.DetailsView), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. A pager row is displayed in a control when the paging feature is enabled (by setting the property to true). The pager row contains the controls that allow the user to navigate to the different pages in the control. Instead of using the built-in pager row user interface (UI), you can define your own UI by using the property. To specify a custom template for the pager row, first place <PagerTemplate> tags between the opening and closing tags of the control. You can then list the contents of the template between the opening and closing <PagerTemplate> tags. To control the appearance of the pager row, use the property. Gets or sets the custom content for the pager row in a control. 2.0.0.0 Method 2.0.0.0 System.Void The method is a helper method called by the control to bind the specified data source to the control. Binds the specified data source to the control. An that represents the data source. Method 2.0.0.0 System.Void The method is a helper method called by the control to set up the control hierarchy in the control before the control is rendered. Sets up the control hierarchy of the control. Method System.Void To be added. The method is a helper method used by the control to create the arguments for the callback handler in the method. Creates the arguments for the callback handler in the method. 2.0.0.0 Method System.Void The page calls the method when a postback event occurs that raises the appropriate events for a control. This call occurs in the page life cycle after loading and change notification are complete, but before prerendering occurs. This method has been implemented to create a object for the events that are raised. This method is used primarily by control developers to extend the control. Raises the appropriate events for the control when it posts back to the server. The event argument from which to create a for the event or events that are raised. 2.0.0.0 Method 2.0.0.0 System.Void The method is used to render the server control content to the client's browser using the specified object. Displays the control on the client using the specified object. An that contains the output stream to render on the client. Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.DetailsViewRowCollection To be added. The property (collection) is used to store the data rows in a control. The control automatically populates the collection by creating a object for each record in the data source and then adding the object to the collection. This property is commonly used to access a specific row in the control or to iterate though the entire collection of rows. Only data rows are stored in the collection. The objects that represent the header, footer, and pager rows are not included in the collection. Gets a collection of objects that represent the data rows in a control. 2.0.0.0 Property System.ComponentModel.DefaultValue(null) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.NotifyParentProperty(true) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.WebControls.TableItemStyle To be added. Use the property to control the appearance of the data rows in a control. When the property is also set, the data rows are displayed alternating between the settings and the settings. This property is read-only; however, you can set the properties of the object it returns. The properties can be set declaratively in the form , where is a property of the object (for example, RowStyle-ForeColor). The properties can also be set programmatically in the form (for example, RowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties. Gets a reference to the object that allows you to set the appearance of the data rows in a control. 2.0.0.0 Method 2.0.0.0 System.Object This method is used to save the state of the properties in the control that need to be persisted, even when the property is set to false. This method is used primarily by control developers to extend the control. Saves the state of the properties in the control that need to be persisted, even when the property is set to false. Returns the server control's current view state. If there is no view state associated with the control, this method returns null. Method System.Object The method is a helper method called by the control to save the state of the control. Saves the current view state of the control. An that contains the saved state of the control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Object To be added. Use the property to determine the data key value for the current record. To retrieve the actual object that represents the data key for the record, use the property. This property is the default property that a object binds to at run time. For more information, see , , and Using Parameters with Data Source Controls. Gets the data key value of the current record in a control. 2.0.0.0 Method 2.0.0.0 System.String The control implements the interface and uses the to retrieve data and the method to return the retrieved data to the control. See the method . The results of the callback. Method 2.0.0.0 System.Void To be added. To be added. Raises the callback event using the specified arguments. Property 2.0.0.0 System.Int32 To be added. This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface. For a description of this member, see . Property 2.0.0.0 System.Int32 To be added. This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface. For a description of this member, see . Method 2.0.0.0 System.Void This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface. For a description of this member, see . A string that represents an optional event argument to pass to the event handler. Method 2.0.0.0 System.String To be added. This method is a helper method that is called by the control to generate its callback script. If the control does not render client script, or if the parameter is null or an empty string (""), this method returns null. Creates the callback script for the control. The callback script for the control. The argument for the callback event. Method 2.0.0.0 System.Web.UI.PostBackOptions To be added. This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface. For a description of this member, see . A with the information required for to construct a valid script that, when executed on the client, initiates a client postback. Property System.Web.UI.HtmlTextWriterTag To be added. The property allows the output stream to write the appropriate HTML markup for the control. Gets the value for the control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.DetailsViewRow To be added. When paging is enabled (by setting the property to true), an additional row called the pager row is automatically displayed in the control. The pager row contains controls that allow the user to navigate to other records, and can be displayed at the top, the bottom, or both the top and bottom of the control. Use the property to programmatically access the object that represents the top pager row in the control. The property is available only after the control creates the bottom pager row in the event. This property is commonly used when you need to programmatically manipulate the top pager row, for example when adding custom content. Any modification to the property must be performed after the control has been rendered; otherwise, the control will overwrite any changes. Gets a object that represents the top pager row in a control. 2.0.0.0 Method System.Void This method is overridden to mark the starting point to begin tracking and saving changes to the control as part of the control's view state. Marks the starting point to begin tracking and saving view-state changes to the control. 2.0.0.0 Method System.Void When the control is in edit mode, use the method to programmatically update the current record in the data source. This method is commonly used when you need to update the current record from outside of the control, such as from a different control on the page. The control must be in edit mode when this method is called; otherwise, an exception is thrown. To specify whether page validation is performed before the update operation, use the parameter. Calling this method also raises the and events. Updates the current record in the data source. true to perform page validation when the method is called; otherwise, false. 2.0.0.0