DetailsViewInsertEventHandler.xml

<Type Name="DetailsViewInsertEventHandler" FullName="System.Web.UI.WebControls.DetailsViewInsertEventHandler">
  <TypeSignature Language="C#" Value="public delegate void DetailsViewInsertEventHandler(object sender, DetailsViewInsertEventArgs e);" />
  <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed DetailsViewInsertEventHandler extends System.MulticastDelegate" />
  <TypeSignature Language="DocId" Value="T:System.Web.UI.WebControls.DetailsViewInsertEventHandler" />
  <TypeSignature Language="VB.NET" Value="Public Delegate Sub DetailsViewInsertEventHandler(sender As Object, e As DetailsViewInsertEventArgs)" />
  <TypeSignature Language="F#" Value="type DetailsViewInsertEventHandler = delegate of obj * DetailsViewInsertEventArgs -&gt; unit" />
  <TypeSignature Language="C++ CLI" Value="public delegate void DetailsViewInsertEventHandler(System::Object ^ sender, DetailsViewInsertEventArgs ^ 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.DetailsViewInsertEventArgs" />
  </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.DetailsViewInsertEventArgs" /> that contains the event data.</param>
    <summary>Represents the method that handles the <see cref="E:System.Web.UI.WebControls.DetailsView.ItemInserting" /> event of a <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</summary>
    <remarks>
      <format type="text/markdown"><![CDATA[  
  
## Remarks  
 The <xref:System.Web.UI.WebControls.DetailsView> control raises the <xref:System.Web.UI.WebControls.DetailsView.ItemInserting> event when an Insert button (a button with its `CommandName` property set to "Insert") within the control is clicked, but before the <xref:System.Web.UI.WebControls.DetailsView> control inserts the record. This allows you to provide an event handler that performs a custom routine, such as HTML-encoding the values of a record before inserting it in the data source, whenever this event occurs.  
  
 When you create a <xref:System.Web.UI.WebControls.DetailsViewInsertEventHandler> 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 code example demonstrates how to programmatically add a <xref:System.Web.UI.WebControls.DetailsViewInsertEventHandler> delegate to the <xref:System.Web.UI.WebControls.DetailsView.ItemInserting> event of a <xref:System.Web.UI.WebControls.DetailsView> control.  
  
 :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/DetailsViewInsertEventHandlerInline/CS/detailsviewinserteventhandlerinlinecs.aspx" id="Snippet1":::
 :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/DetailsViewInsertEventHandlerInline/VB/detailsviewinserteventhandlerinlinevb.aspx" id="Snippet1":::  
  
 The following code example demonstrates how to declaratively add a <xref:System.Web.UI.WebControls.DetailsViewInsertEventHandler> delegate to the <xref:System.Web.UI.WebControls.DetailsView.ItemInserting> event of a <xref:System.Web.UI.WebControls.DetailsView> control.  
  
 :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/DetailsViewInsertEventHandler/CS/detailsviewinserteventhandlercs.aspx" id="Snippet1":::
 :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/DetailsViewInsertEventHandler/VB/detailsviewinserteventhandlervb.aspx" id="Snippet1":::  
  
 ]]></format>
    </remarks>
    <altmember cref="T:System.Web.UI.WebControls.DetailsView" />
    <altmember cref="T:System.Web.UI.WebControls.DetailsViewInsertEventArgs" />
    <altmember cref="E:System.Web.UI.WebControls.DetailsView.ItemInserting" />
    <altmember cref="M:System.Web.UI.WebControls.DetailsView.OnItemInserting(System.Web.UI.WebControls.DetailsViewInsertEventArgs)" />
  </Docs>
</Type>