ListViewUpdatedEventArgs ListViewUpdatedEventArgs ListViewUpdatedEventArgs ListViewUpdatedEventArgs Class

Definition

Stellt Daten für das ItemUpdated-Ereignis bereit.Provides data for the ItemUpdated event.

public ref class ListViewUpdatedEventArgs : EventArgs
public class ListViewUpdatedEventArgs : EventArgs
type ListViewUpdatedEventArgs = class
    inherit EventArgs
Public Class ListViewUpdatedEventArgs
Inherits EventArgs
Vererbung
ListViewUpdatedEventArgsListViewUpdatedEventArgsListViewUpdatedEventArgsListViewUpdatedEventArgs

Beispiele

Im folgenden Beispiel wird gezeigt, wie das ListViewUpdatedEventArgs -Objekt verwendet wird, um zu bestimmen, ob während eines Aktualisierungs Vorgangs eine Ausnahme aufgetreten ist.The following example shows how to use the ListViewUpdatedEventArgs object to determine whether an exception occurred during an update operation.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<%@ 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 Page_Load()
    {
        Message.Text = String.Empty;
    }
        
    //<Snippet2>
    void ContactsListView_ItemUpdated(Object sender, ListViewUpdatedEventArgs e)
    {
        if (e.Exception != null)
        {
            if (e.AffectedRows == 0)
            {
                e.KeepInEditMode = true;
                Message.Text = "An exception occurred updating the contact. " +
                                    "Please verify your values and try again.";
            }
            else
                Message.Text = "An exception occurred updating the contact. " +
                                    "Please verify the values in the recently updated item.";

            e.ExceptionHandled = true;
        }
    }
   //</Snippet2>
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView.ItemUpdated Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ListView.ItemUpdated Example</h3>
            
      <asp:Label ID="Message"
        ForeColor="Red"          
        runat="server"/>
      <br/>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        OnItemUpdated="ContactsListView_ItemUpdated"  
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" border="1" runat="server" id="tblContacts" width="640px">
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="PeopleDataPager" PageSize="12">
             <Fields>
               <asp:NextPreviousPagerField 
                ShowFirstPageButton="True" ShowLastPageButton="True"
                    FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                    NextPageText=" &gt; " PreviousPageText=" &lt; " />
             </Fields>
           </asp:DataPager>
         </LayoutTemplate>
         <ItemTemplate>
            <tr runat="server">
              <td valign="top">
                <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
                <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
              </td>
              <td>
                <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
              </td>
              <td>
                <asp:LinkButton ID="EditButton" runat="server" CommandName="Edit" Text="Edit" />
              </td>
            </tr>
          </ItemTemplate>
          <EditItemTemplate>
            <tr style="background-color:#ADD8E6">
              <td valign="top">
                <asp:Label runat="server" ID="FirstNameLabel" 
                  AssociatedControlID="FirstNameTextBox" Text="First Name"/>
                <asp:TextBox ID="FirstNameTextBox" runat="server"
                  Text='<%# Bind("FirstName") %>' MaxLength="50" Width="200px" /><br />
                <asp:Label runat="server" ID="LastNameLabel" 
                  AssociatedControlID="LastNameTextBox" Text="Last Name" />
                <asp:TextBox ID="LastNameTextBox" runat="server" 
                  Text='<%# Bind("LastName") %>' MaxLength="50" Width="200px" /><br />
                <asp:Label runat="server" ID="EmailLabel" 
                  AssociatedControlID="EmailTextBox" Text="Email" />
                <asp:TextBox ID="EmailTextBox" runat="server" 
                  Text='<%# Bind("EmailAddress") %>' MaxLength="50" Width="200px" />
              </td>
              <td colspan="2" valign="top">
                <asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
                <asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
              </td>
            </tr>
          </EditItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName], [EmailAddress] 
          FROM Person.Contact"
        UpdateCommand="UPDATE Person.Contact
          Set [FirstName] = @FirstName, [LastName] = @LastName, [EmailAddress] = @EmailAddress 
          WHERE [ContactID] = @ContactID">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>
<%@ Page language="VB" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<script runat="server">

    Sub Page_Load()
        Message.Text = String.Empty
    End Sub

    '<Snippet2>
    Sub ContactsListView_ItemUpdated(sender As Object, e As ListViewUpdatedEventArgs)
        If e.Exception IsNot Nothing Then
            If e.AffectedRows = 0 Then
                e.KeepInEditMode = True
                Message.Text = "An exception occurred updating the contact. " & _
                                    "Please verify your values and try again."
            Else
                Message.Text = "An exception occurred updating the contact. " & _
                                    "Please verify the values in the recently updated item."
            End If

            e.ExceptionHandled = True
        End If
    End Sub
   '</Snippet2>
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView.ItemUpdated Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ListView.ItemUpdated Example</h3>
            
      <asp:Label ID="Message"
        ForeColor="Red"          
        runat="server"/>
      <br/>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        OnItemUpdated="ContactsListView_ItemUpdated"  
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" border="1" runat="server" id="tblContacts" width="640px">
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="PeopleDataPager" PageSize="12">
             <Fields>
               <asp:NextPreviousPagerField 
                ShowFirstPageButton="True" ShowLastPageButton="True"
                    FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                    NextPageText=" &gt; " PreviousPageText=" &lt; " />
             </Fields>
           </asp:DataPager>
         </LayoutTemplate>
         <ItemTemplate>
            <tr>
              <td valign="top">
                <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
                <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
              </td>
              <td>
                <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
              </td>
              <td>
                <asp:LinkButton ID="EditButton" runat="server" CommandName="Edit" Text="Edit" />
              </td>
            </tr>
          </ItemTemplate>
          <EditItemTemplate>
            <tr style="background-color:#ADD8E6">
              <td valign="top">
                <asp:Label runat="server" ID="FirstNameLabel" 
                  AssociatedControlID="FirstNameTextBox" Text="First Name"/>
                <asp:TextBox ID="FirstNameTextBox" runat="server"
                  Text='<%# Bind("FirstName") %>' MaxLength="50" Width="200px" /><br />
                <asp:Label runat="server" ID="LastNameLabel" 
                  AssociatedControlID="LastNameTextBox" Text="Last Name" />
                <asp:TextBox ID="LastNameTextBox" runat="server" 
                  Text='<%# Bind("LastName") %>' MaxLength="50" Width="200px" /><br />
                <asp:Label runat="server" ID="EmailLabel" 
                  AssociatedControlID="EmailTextBox" Text="Email" />
                <asp:TextBox ID="EmailTextBox" runat="server" 
                  Text='<%# Bind("EmailAddress") %>' MaxLength="50" Width="200px" />
              </td>
              <td colspan="2" valign="top">
                <asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
                <asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
              </td>
            </tr>
          </EditItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName], [EmailAddress] 
          FROM Person.Contact"
        UpdateCommand="UPDATE Person.Contact
          Set [FirstName] = @FirstName, [LastName] = @LastName, [EmailAddress] = @EmailAddress 
          WHERE [ContactID] = @ContactID">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Hinweise

Das ListView -Steuerelement ItemUpdated löst das- UpdateItem Ereignis aus, wenn die-Methode aufgerufen wird oder wenn auf eine Aktualisierungs Schaltfläche im-Steuerelement geklickt wird, aber nachdem ListView das-Steuerelement dasThe ListView control raises the ItemUpdated event when the UpdateItem method is called or when an Update button in the control is clicked, but after the ListView control updates the item. (Eine Aktualisierungs Schaltfläche ist CommandName eine Schaltfläche, deren-Eigenschaft auf "Update" festgelegt ist.) Dies ermöglicht es Ihnen, eine Ereignis Behandlungsmethode bereitzustellen, die bei jedem Auftreten dieses Ereignisses eine benutzerdefinierte Routine ausführt, z. b. das Überprüfen der Ergebnisse eines Aktualisierungs Vorgangs.(An Update button is a button whose CommandName property is set to "Update".) This enables you to provide an event-handling method that performs a custom routine whenever this event occurs, such as checking the results of an update operation.

Ein ListViewUpdatedEventArgs -Objekt wird an die Ereignis Behandlungsmethode übermittelt.A ListViewUpdatedEventArgs object is passed to the event-handling method. Mit diesem Objekt können Sie die Anzahl der aktualisierten Elemente ermitteln und ggf. aufgetretene Ausnahmen erhalten.This object enables you to determine the number of items updated and to get any exceptions that might have occurred. Verwenden Sie die AffectedRows -Eigenschaft, um die Anzahl der Elemente zu ermitteln, die vom Aktualisierungs Vorgang betroffen sind.To determine the number of items that were affected by the update operation, use the AffectedRows property. Verwenden Sie die Exception -Eigenschaft, um zu bestimmen, ob Ausnahmen aufgetreten sind.To determine whether any exceptions occurred, use the Exception property. Sie können angeben, ob die Ausnahme in der Ereignis Behandlungsmethode behandelt wurde, indem Sie ExceptionHandled die-Eigenschaft festlegen.You can indicate whether the exception was handled in the event-handling method by setting the ExceptionHandled property. Sie können auf die ursprünglichen Feldwerte mithilfe der OldValues -Eigenschaft zugreifen.You can access the original field values by using the OldValues property. Mithilfe der NewValues -Eigenschaft können Sie auf aktualisierte Feldwerte zugreifen.You can access updated field values by using the NewValues property.

Standardmäßig wird das ListView Element nach einem Aktualisierungs Vorgang in den schreibgeschützten Modus zurückgegeben.By default, the ListView item returns to read-only mode after an update operation. Wenn Sie eine Ausnahme behandeln, die während des Aktualisierungs Vorgangs aufgetreten ist, können ListView Sie das Element im Bearbeitungsmodus belassen KeepInEditMode , indem trueSie die-Eigenschaft auf festlegen.If you handle an exception that occurred during the update operation, you can keep the ListView item in edit mode by setting the KeepInEditMode property to true.

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

Konstruktoren

ListViewUpdatedEventArgs(Int32, Exception) ListViewUpdatedEventArgs(Int32, Exception) ListViewUpdatedEventArgs(Int32, Exception) ListViewUpdatedEventArgs(Int32, Exception)

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

Eigenschaften

AffectedRows AffectedRows AffectedRows AffectedRows

Ruft die Anzahl der vom Aktualisierungsvorgang betroffenen Zeilen ab.Gets the number of rows that were affected by the update operation.

Exception Exception Exception Exception

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

ExceptionHandled ExceptionHandled ExceptionHandled ExceptionHandled

Ruft einen Wert ab, der angibt, ob während des Ereignisses eine Ausnahme behandelt wurde, die während des Aktualisierungsvorgangs ausgelöst wurde, oder legt diesen fest.Gets or sets a value that indicates whether an exception that was raised during the update operation was handled during the event.

KeepInEditMode KeepInEditMode KeepInEditMode KeepInEditMode

Ruft einen Wert ab, der angibt, ob das ListView-Steuerelement nach einem Aktualisierungsvorgang im Bearbeitungsmodus belassen werden soll, oder legt diesen fest.Gets or sets a value that indicates whether the ListView control should remain in edit mode after an update operation.

NewValues NewValues NewValues NewValues

Ruft ein Wörterbuch ab, das die neuen Werte für das aktualisierte Element enthält.Gets a dictionary that contains the new values for the updated item.

OldValues OldValues OldValues OldValues

Ruft ein Wörterbuch ab, das die ursprünglichen Werte für das aktualisierte Element enthält.Gets a dictionary that contains the original values for the updated item.

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