DetailsViewInsertedEventArgs DetailsViewInsertedEventArgs DetailsViewInsertedEventArgs DetailsViewInsertedEventArgs Class

Definition

Stellt Daten für das ItemInserted-Ereignis bereit.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
Vererbung
DetailsViewInsertedEventArgsDetailsViewInsertedEventArgsDetailsViewInsertedEventArgsDetailsViewInsertedEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das DetailsViewInsertedEventArgs -Objekt verwendet wird, das an den ItemInserted -Ereignishandler für das-Ereignis übermittelt wird, um zu bestimmen, ob während eines EinfügevorgangsThe 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>

Hinweise

Das DetailsView -Steuerelement ItemInserted löst das-Ereignis aus, DetailsView wenn auf eine einfügeschaltfläche (eine Schaltfläche, deren CommandName -Eigenschaft auf "Einfügen" festgelegt ist) im-Steuerelement geklickt wirdThe 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. Dies ermöglicht Ihnen die Bereitstellung eines Ereignis Handlers, der eine benutzerdefinierte Routine ausführt, z. b. das Überprüfen der Ergebnisse eines Einfügevorgangs, wenn dieses Ereignis auftritt.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.

Ein DetailsViewInsertedEventArgs -Objekt wird an den-Ereignishandler übermittelt, mit dem Sie die Anzahl der betroffenen Datensätze und ggf. aufgetretenen Ausnahmen ermitteln können.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. Verwenden Sie die AffectedRows -Eigenschaft, um die Anzahl der vom Einfügevorgang betroffenen Datensätze zu bestimmen.To determine the number of records affected by the insert operation, use the AffectedRows property. Verwenden Sie Exception die-Eigenschaft, um zu bestimmen, ob Ausnahmen aufgetreten sind.Use the Exception property to determine whether any exceptions occurred. Sie können auch angeben, ob die Ausnahme im Ereignishandler behandelt wurde, indem Sie ExceptionHandled die-Eigenschaft festlegen.You can also indicate whether the exception was handled in the event handler by setting the ExceptionHandled property. Wenn Sie auf die Werte des eingefügten Datensatzes zugreifen müssen, Values verwenden Sie die-Eigenschaft.If you need to access the values of the inserted record, use the Values property.

Standardmäßig wird das DetailsView -Steuerelement nach einem Einfügevorgang in den von der DefaultMode -Eigenschaft angegebenen Modus zurückgegeben.By default, the DetailsView control returns to the mode specified by the DefaultMode property after an insert operation. Um das DetailsView Steuerelement im Einfügemodus beizubehalten, legen trueSie die KeepInInsertMode -Eigenschaft auf fest.To keep the DetailsView control in insert mode, set the KeepInInsertMode property to true.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der DetailsViewDeletedEventArgs-Klasse finden Sie im DetailsViewDeletedEventArgs-Konstruktor.For a list of initial property values for an instance of the DetailsViewDeletedEventArgs class, see the DetailsViewDeletedEventArgs constructor.

Konstruktoren

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

Initialisiert eine neue Instanz der DetailsViewInsertedEventArgs-Klasse.Initializes a new instance of the DetailsViewInsertedEventArgs class.

Eigenschaften

AffectedRows AffectedRows AffectedRows AffectedRows

Ruft die Anzahl der vom Einfügevorgang betroffenen Zeilen ab.Gets the number of rows affected by the insert operation.

Exception Exception Exception Exception

Ruft die Ausnahme (sofern vorhanden) ab, die während des Einfügevorgangs ausgelöst wurde.Gets the exception (if any) that was raised during the insert operation.

ExceptionHandled ExceptionHandled ExceptionHandled ExceptionHandled

Ruft einen Wert ab, der angibt, ob eine Ausnahme, die während des Einfügevorgangs ausgelöst wurde, im Ereignishandler behandelt wurde, oder legt einen entsprechenden Wert fest.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

Ruft einen Wert ab, der anzeigt, ob das DetailsView-Steuerelement nach einem Einfügevorgang im Einfügemodus belassen werden soll, oder legt diesen Wert fest.Gets or sets a value indicating whether the DetailsView control should remain in insert mode after an insert operation.

Values Values Values Values

Ruft ein Wörterbuch ab, das die Name-Wert-Paare der Felder für den eingefügten Datensatz enthält.Gets a dictionary that contains the field name/value pairs for the inserted record.

Methoden

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch