Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ListViewUpdatedEventArgs

 

Data di pubblicazione: ottobre 2016

Fornisce dati per l'evento ItemUpdated.

Spazio dei nomi:   System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

System.Object
  System.EventArgs
    System.Web.UI.WebControls.ListViewUpdatedEventArgs

public class ListViewUpdatedEventArgs : EventArgs

NomeDescrizione
System_CAPS_pubmethodListViewUpdatedEventArgs(Int32, Exception)

Inizializza una nuova istanza della classe ListViewUpdatedEventArgs.

NomeDescrizione
System_CAPS_pubpropertyAffectedRows

Ottiene il numero di righe interessate dall'operazione di aggiornamento.

System_CAPS_pubpropertyException

Ottiene l'eccezione, se presente, che è stata generata durante l'operazione di aggiornamento.

System_CAPS_pubpropertyExceptionHandled

Ottiene o imposta un valore che indica se un'eccezione generata durante l'operazione di aggiornamento è stata gestita durante l'evento.

System_CAPS_pubpropertyKeepInEditMode

Ottiene o imposta un valore che indica se il ListView controllo deve rimanere in modalità di modifica dopo un'operazione di aggiornamento.

System_CAPS_pubpropertyNewValues

Ottiene un dizionario che contiene i nuovi valori per l'elemento aggiornato.

System_CAPS_pubpropertyOldValues

Ottiene un dizionario che contiene i valori originali per l'elemento aggiornato.

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

Il ListView controllo genera il ItemUpdated eventi quando il UpdateItem viene chiamato o quando un pulsante Aggiorna nel controllo è selezionato, ma dopo che il ListView ha aggiornato l'elemento. (Un pulsante di aggiornamento è un pulsante la cui CommandName proprietà è impostata su "Update".) In questo modo è possibile fornire un metodo di gestione degli eventi che esegue una routine personalizzata ogni volta che si verifica questo evento, ad esempio controllare i risultati di un'operazione di aggiornamento.

Oggetto ListViewUpdatedEventArgs oggetto viene passato al metodo di gestione degli eventi. Questo oggetto consente di determinare il numero di elementi aggiornati e per ottenere tutte le eccezioni che potrebbero essersi verificati. Per determinare il numero di elementi che sono stati interessati dall'operazione di aggiornamento, utilizzare il AffectedRows proprietà. Per determinare se è stata generata un'eccezione, utilizzare il Exception proprietà. È possibile indicare se l'eccezione è stata gestita nel metodo di gestione degli eventi impostando il ExceptionHandled proprietà. È possibile accedere ai valori di campo originale utilizzando il OldValues proprietà. È possibile accedere a valori dei campi aggiornati tramite il NewValues proprietà.

Per impostazione predefinita, il ListView elemento torna alla modalità di sola lettura dopo un'operazione di aggiornamento. Se si gestisce un'eccezione che si sono verificati durante l'operazione di aggiornamento, è possibile mantenere il ListView elemento in modalità di modifica impostando il KeepInEditMode proprietà true.

Per un elenco dei valori iniziali delle proprietà di un'istanza della classe ListViewUpdatedEventArgs, vedere il costruttore ListViewUpdatedEventArgs.

Nell'esempio seguente viene illustrato come utilizzare il ListViewUpdatedEventArgs per determinare se è stata generata un'eccezione durante un'operazione di aggiornamento.

System_CAPS_security Sicurezza Nota

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere 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;
    }

    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;
        }
    }

</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="E-mail" />
                <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>

.NET Framework
Disponibile da 3.5

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: