Enabling Row Editing (WebDataGrid)

This topic details how to enable the Row Editing behavior in the WebDataGrid ™ .

The following topics are prerequisites to understanding this topic:

This topic contains the following sections:

The following table summarizes the ways to enable row editing for the WebDataGrid . The full procedures are available after this summary table.

This procedure enables the Row Editing and Editing Core behaviors of the WebDataGrid using the control’s Designer. You enable these behaviors by setting the respective options from WebDataGrid ’s smart tag.

The following screenshot is a preview of the final result – the WebDataGrid has row editing enabled as evidenced by a row that has entered Edit mode as a result of a user action.

To complete the procedure, you need the following:

Following is a conceptual overview of the process:

1. Accessing the Behaviors’ options

2. Enabling row editing in the options

3. (Optional) Verifying the result

The following steps demonstrate how to enable the Row Editing behavior in the designer.

1. Open the WebDataGrid’s smart tag .

In the Designer, click the smart tag button to open the WebDataGrid ‘s Designer.

2. Click Edit Behaviors .

This opens the designer for the WebDataGrid’s behaviors.

1. Check the box for Row Editing Behavior

2. Click OK to commit your changes and close the Designer window . The Row Editing behavior takes a dependency on the Editing Core behavior and thus that behavior is checked automatically.

To verify the result, run the project and double-click on a row . You will see the row editing behavior.

You enable the Row Editing and Editing Core behaviors by adding the respective ASPX markup to the web form. This is the same markup that is generated when using the Designer (See Enabling Row Editing with the WebDataGrid Designer). Because the Row Editing behavior requires the EditingCore behavior, you will add that as well.

The following screenshot is a preview of the final result.

To complete the procedure, you need the following:

Following is a conceptual overview of the process:

1. Adding the EditingCore behavior

2. Adding the RowEditing behavior

3. (Optional) Verifying the result

The following steps demonstrate how to enable the Row Editing behavior in ASPX markup.

Add the EditingCore Behavior to the WebDataGrid behaviors collection.

The Behaviors tag is nested within the WebDataGrid tags. If you already have other behaviors defined, the EditingCore behavior is added as a sibling of those behaviors within the Behaviors tag.

In ASPX:

Add the RowEditing behavior within the EditingCore`s behaviors collection. The EditingCore behavior has a 'Behaviors' collection similar to the grid. The RowEditing behavior is defined within the 'Behaviors' tag of the 'EditingCore' tag.

In ASPX:

To verify the result, save and run the project and double-click on a row . You will see the row editing behavior.

1. Save the ASPX for your page.

At this point, the code and grid should have the following code elements and functionality.

In ASPX:

2. Run the project and double click on a row. You will see the row editing behavior.

This procedure adds the RowEditing behavior to the WebDataGrid at run-time in the code-behind. This approach is useful when you want to add the behavior conditionally. The RowEditing behavior is added to the EditingCore behavior’s Behaviors collection so you will add the EditingCore behavior at runtime as well. You can use the page init or the page load events to add the behaviors during the page lifecycle. This example uses page load.

The following screenshot is a preview of the final result.

To complete the procedure, you need the following:

Following is a conceptual overview of the process:

1. Adding the EditingCore behavior

2. Adding the RowEditing behavior

3. (Optional) Verifying the result

The following steps demonstrate how to enable the Row Editing behavior in the code-behind.

Add the EditingCore Behavior to the WebDataGrid behaviors collection

The EditingCore behavior is added directly to the WebDataGrid’s Behaviors collection using the CreateBehavior method.

In C#:

In C#:

To verify the result, save and run the project and double-click on a row . You will see the row editing behavior. 1. Save the code-behind file.

At this point, the code should include the following:

In C#:

2. Run the project and double click on a row. You will see the row editing behavior.

The following topics provide additional information related to this topic.

The following samples provide additional information related to this topic.