/
GridViewRowEventHandler.xml
59 lines (49 loc) · 4.99 KB
/
GridViewRowEventHandler.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
<Type Name="GridViewRowEventHandler" FullName="System.Web.UI.WebControls.GridViewRowEventHandler">
<TypeSignature Language="C#" Value="public delegate void GridViewRowEventHandler(object sender, GridViewRowEventArgs e);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed GridViewRowEventHandler extends System.MulticastDelegate" />
<TypeSignature Language="DocId" Value="T:System.Web.UI.WebControls.GridViewRowEventHandler" />
<TypeSignature Language="VB.NET" Value="Public Delegate Sub GridViewRowEventHandler(sender As Object, e As GridViewRowEventArgs)" />
<TypeSignature Language="F#" Value="type GridViewRowEventHandler = delegate of obj * GridViewRowEventArgs -> unit" />
<TypeSignature Language="C++ CLI" Value="public delegate void GridViewRowEventHandler(System::Object ^ sender, GridViewRowEventArgs ^ e);" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.Web.UI.WebControls.GridViewRowEventArgs" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Docs>
<param name="sender">The source of the event.</param>
<param name="e">A <see cref="T:System.Web.UI.WebControls.GridViewRowEventArgs" /> object that contains the event data.</param>
<summary>Represents the method that handles the <see cref="E:System.Web.UI.WebControls.GridView.RowCreated" /> and <see cref="E:System.Web.UI.WebControls.GridView.RowDataBound" /> events of a <see cref="T:System.Web.UI.WebControls.GridView" /> control.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Before the <xref:System.Web.UI.WebControls.GridView> control can be rendered, a <xref:System.Web.UI.WebControls.GridViewRow> object must be created for each row in the control. The <xref:System.Web.UI.WebControls.GridView.RowCreated> event is raised each time a row in the <xref:System.Web.UI.WebControls.GridView> control is created. This allows you to provide an event-handling method that performs a custom routine, such as adding custom content to a row, whenever this event occurs.
Similarly, each row in the control must be bound to a record in the data source before the <xref:System.Web.UI.WebControls.GridView> control can be rendered. The <xref:System.Web.UI.WebControls.GridView.RowDataBound> event is raised when a data row (represented by a <xref:System.Web.UI.WebControls.GridViewRow> object) is bound to data in the <xref:System.Web.UI.WebControls.GridView> control. This allows you to provide an event-handling method that performs a custom routine, such as modifying the values of the data bound to the row, whenever this event occurs.
When you create a <xref:System.Web.UI.WebControls.GridViewRowEventHandler> delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see [Handling and Raising Events](/dotnet/standard/events/).
## Examples
The following example demonstrates how to programmatically add a <xref:System.Web.UI.WebControls.GridViewRowEventHandler> delegate to the <xref:System.Web.UI.WebControls.GridView.RowDataBound> event of a <xref:System.Web.UI.WebControls.GridView> control.
:::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/GridViewRowEventHandler/CS/gridviewroweventhandlercs.aspx" id="Snippet1":::
:::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/GridViewRowEventHandler/VB/gridviewroweventhandlervb.aspx" id="Snippet1":::
The following example demonstrates how to declaratively add a <xref:System.Web.UI.WebControls.GridViewRowEventHandler> delegate to the <xref:System.Web.UI.WebControls.GridView.RowDataBound> event of a <xref:System.Web.UI.WebControls.GridView> control.
:::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/GridViewRowDataBound/CS/gridviewrowdataboundcs.aspx" id="Snippet1":::
:::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/GridViewRowDataBound/VB/gridviewrowdataboundvb.aspx" id="Snippet1":::
]]></format>
</remarks>
<altmember cref="T:System.Web.UI.WebControls.GridView" />
<altmember cref="T:System.Web.UI.WebControls.GridViewRowEventArgs" />
<altmember cref="E:System.Web.UI.WebControls.GridView.RowCreated" />
<altmember cref="M:System.Web.UI.WebControls.GridView.OnRowCreated(System.Web.UI.WebControls.GridViewRowEventArgs)" />
<altmember cref="E:System.Web.UI.WebControls.GridView.RowDataBound" />
<altmember cref="M:System.Web.UI.WebControls.GridView.OnRowDataBound(System.Web.UI.WebControls.GridViewRowEventArgs)" />
</Docs>
</Type>