DetailsViewInsertedEventArgs DetailsViewInsertedEventArgs DetailsViewInsertedEventArgs DetailsViewInsertedEventArgs Class

Definizione

Fornisce dati per l'evento ItemInserted.Provides data for the ItemInserted event.

public ref class DetailsViewInsertedEventArgs : EventArgs
public class DetailsViewInsertedEventArgs : EventArgs
type DetailsViewInsertedEventArgs = class
    inherit EventArgs
Public Class DetailsViewInsertedEventArgs
Inherits EventArgs
Ereditarietà
DetailsViewInsertedEventArgsDetailsViewInsertedEventArgsDetailsViewInsertedEventArgsDetailsViewInsertedEventArgs

Esempi

Nell'esempio di codice riportato di seguito viene illustrato DetailsViewInsertedEventArgs come utilizzare l'oggetto passato al gestore eventi ItemInserted per l'evento per determinare se si è verificata un'eccezione durante un'operazione di inserimento.The following code example demonstrates how to use the DetailsViewInsertedEventArgs object passed to the event handler for the ItemInserted event to determine whether an exception occurred during an insert operation.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomerDetailsView_ItemInserted(Object sender, 
    DetailsViewInsertedEventArgs e)
  {
    // Use the Exception property to determine whether an exception
    // occurred during the insert operation.
    if (e.Exception == null && e.AffectedRows == 1)
    {
      // Use the Values property to get the value entered by 
      // the user for the CompanyName field.
      String name = e.Values["CompanyName"].ToString();

      // Display a confirmation message.
      MessageLabel.Text = name + " added successfully. ";

    }
    else
    {
      // Insert the code to handle the exception.
      MessageLabel.Text = e.Exception.Message;
      
      // Use the ExceptionHandled property to indicate that the 
      // exception is already handled.
      e.ExceptionHandled = true;
      
      // When an exception occurs, keep the DetailsView
      // control in insert mode.
      e.KeepInInsertMode = true;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewInsertedEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewInsertedEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          oniteminserted="CustomerDetailsView_ItemInserted" 
          runat="server">
               
          <fieldheaderstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], 
            [City], [PostalCode], [Country] From [Customers]"
          insertcommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], 
            [Country]) VALUES (@CustomerID, @CompanyName, @Address, 
            @City, @PostalCode, @Country)"
          connectionstring=
            "<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>


<%@ Page language="VB" autoeventwireup="false" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub CustomerDetailsView_ItemInserted(ByVal sender As Object, _
    ByVal e As DetailsViewInsertedEventArgs) _
    Handles CustomerDetailsView.ItemInserted

    ' Use the Exception property to determine whether an exception
    ' occurred during the insert operation.
    If e.Exception Is Nothing And e.AffectedRows = 1 Then
    
      ' Use the Values property to get the value entered by 
      ' the user for the CompanyName field.
      Dim name As String = e.Values("CompanyName").ToString()

      ' Display a confirmation message.
      MessageLabel.Text = name & " added successfully. "
    
    Else
    
      ' Insert the code to handle the exception.
      MessageLabel.Text = e.Exception.Message
      
      ' Use the ExceptionHandled property to indicate that the 
      ' exception is already handled.
      e.ExceptionHandled = True
      
      ' When an exception occurs, keep the DetailsView
      ' control in insert mode.
      e.KeepInInsertMode = True
    
    End If
        
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewInsertedEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewInsertedEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          runat="server">
               
          <fieldheaderstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], 
            [City], [PostalCode], [Country] From [Customers]"
          insertcommand="INSERT INTO [Customers]([CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          connectionstring=
            "<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Commenti

Il DetailsView controllo genera l' ItemInserted evento quando viene fatto clic su un pulsante di inserimento CommandName (un pulsante con la relativa proprietà impostata su "Insert") all'interno del controllo DetailsView , ma dopo l'inserimento del record da parte del controllo.The DetailsView control raises the ItemInserted event when an Insert button (a button with its CommandName property set to "Insert") within the control is clicked, but after the DetailsView control inserts the record. In questo modo è possibile fornire un gestore eventi che esegue una routine personalizzata, ad esempio il controllo dei risultati di un'operazione di inserimento, ogni volta che si verifica questo evento.This allows you to provide an event handler that performs a custom routine, such as checking the results of an insert operation, whenever this event occurs.

Un DetailsViewInsertedEventArgs oggetto viene passato al gestore eventi, che consente di determinare il numero di record interessati ed eventuali eccezioni che potrebbero essersi verificate.A DetailsViewInsertedEventArgs object is passed to the event handler, which allows you to determine the number of records affected and any exceptions that might have occurred. Per determinare il numero di record interessati dall'operazione di inserimento, utilizzare la AffectedRows proprietà.To determine the number of records affected by the insert operation, use the AffectedRows property. Utilizzare la Exception proprietà per determinare se si sono verificate eccezioni.Use the Exception property to determine whether any exceptions occurred. È inoltre possibile indicare se l'eccezione è stata gestita nel gestore eventi impostando la ExceptionHandled proprietà.You can also indicate whether the exception was handled in the event handler by setting the ExceptionHandled property. Se è necessario accedere ai valori del record inserito, utilizzare la Values proprietà.If you need to access the values of the inserted record, use the Values property.

Per impostazione predefinita, DetailsView il controllo torna alla modalità specificata DefaultMode dalla proprietà dopo un'operazione di inserimento.By default, the DetailsView control returns to the mode specified by the DefaultMode property after an insert operation. Per rendere il DetailsView controllo in modalità di inserimento, impostare KeepInInsertMode la proprietà truesu.To keep the DetailsView control in insert mode, set the KeepInInsertMode property to true.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.For more information about how to handle events, see Handling and Raising Events.

Per un elenco dei valori iniziali delle proprietà di un'istanza della classe DetailsViewDeletedEventArgs, vedere il costruttore DetailsViewDeletedEventArgs.For a list of initial property values for an instance of the DetailsViewDeletedEventArgs class, see the DetailsViewDeletedEventArgs constructor.

Costruttori

DetailsViewInsertedEventArgs(Int32, Exception) DetailsViewInsertedEventArgs(Int32, Exception) DetailsViewInsertedEventArgs(Int32, Exception) DetailsViewInsertedEventArgs(Int32, Exception)

Inizializza una nuova istanza della classe DetailsViewInsertedEventArgs.Initializes a new instance of the DetailsViewInsertedEventArgs class.

Proprietà

AffectedRows AffectedRows AffectedRows AffectedRows

Ottiene il numero di righe interessate dall'operazione di inserimento.Gets the number of rows affected by the insert operation.

Exception Exception Exception Exception

Ottiene l'eventuale eccezione generata durante l'operazione di inserimento.Gets the exception (if any) that was raised during the insert operation.

ExceptionHandled ExceptionHandled ExceptionHandled ExceptionHandled

Ottiene o imposta un valore che indica se un'eccezione generata durante l'operazione di inserimento è stata gestita nel gestore eventi.Gets or sets a value indicating whether an exception that was raised during the insert operation was handled in the event handler.

KeepInInsertMode KeepInInsertMode KeepInInsertMode KeepInInsertMode

Ottiene o imposta un valore che indica se il controllo DetailsView deve rimanere in modalità di inserimento dopo un'operazione di inserimento.Gets or sets a value indicating whether the DetailsView control should remain in insert mode after an insert operation.

Values Values Values Values

Ottiene un dizionario contenente le coppie nome/valore dei campi per il record inserito.Gets a dictionary that contains the field name/value pairs for the inserted record.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche