Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe ListViewUpdatedEventArgs

fornisce i dati per ItemUpdated evento.

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

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)
public class ListViewUpdatedEventArgs : EventArgs

Il tipo ListViewUpdatedEventArgs espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoListViewUpdatedEventArgsInizializza una nuova istanza di ListViewUpdatedEventArgs classe.
In alto
  NomeDescrizione
Proprietà pubblicaAffectedRowsOttiene il numero di righe che sono state interessate dall'operazione di aggiornamento.
Proprietà pubblicaExceptionOttiene l'eccezione, se presente, che è stata generata un'eccezione durante l'operazione di aggiornamento.
Proprietà pubblicaExceptionHandledOttiene o imposta un valore che indica se un'eccezione generata durante l'operazione di aggiornamento è stato gestito durante l'evento.
Proprietà pubblicaKeepInEditModeOttiene o imposta un valore che indica se ListView il controllo dovrebbe restare in modalità di modifica dopo un'operazione di aggiornamento.
Proprietà pubblicaNewValuesottiene un dizionario che contiene i nuovi valori per l'elemento aggiornato.
Proprietà pubblicaOldValuesottiene un dizionario che contiene i valori originali per l'elemento aggiornato.
In alto
  NomeDescrizione
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protettoFinalize 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)
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (Ereditato da Object)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo protettoMemberwiseCloneConsente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
In alto

ListView il controllo genera ItemUpdated evento quando UpdateItem viene chiamato il metodo o quando un pulsante di aggiornamento nel controllo è selezionato, ma dopo ListView il controllo aggiorna l'elemento. (Un pulsante di aggiornamento è un pulsante di cui CommandName la proprietà è impostata su “per aggiornare„). Ciò consente di fornire un metodo per la gestione eventi per eseguire una routine personalizzata ogni volta che si verifica questo evento, come verificare i risultati di un'operazione di aggiornamento.

In ListViewUpdatedEventArgs l'oggetto viene passato al metodo per la gestione eventi. Questo oggetto consente di determinare il numero di elementi aggiornati e per ottenere tutte le eccezioni che possono verificarsi. Per determinare il numero di elementi interessati dall'operazione di aggiornamento, utilizzare AffectedRows proprietà. Per determinare se le eccezioni si sono verificate, utilizzare Exception proprietà. È possibile indicare se l'eccezione è stata gestita nel metodo per la gestione eventi impostando ExceptionHandled proprietà. È possibile accedere ai valori di campo originali utilizzando OldValues proprietà. È possibile accedere ai valori dei campi aggiornati tramite NewValues proprietà.

per impostazione predefinita, ListView restituisce l'elemento in modalità di sola lettura dopo un'operazione di aggiornamento. Se si gestisce un'eccezione verificatasi durante l'operazione di aggiornamento, è possibile mantenere ListView elemento in modalità di modifica impostando KeepInEditMode proprietà di true.

Per un elenco di valori di proprietà iniziali per un'istanza di ListViewUpdatedEventArgs la classe, vedere ListViewUpdatedEventArgs costruttore.

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

Nota sulla sicurezzaNota sulla sicurezza

In questo esempio è inclusa una casella di testo che accetta l'input dell'utente, 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 ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.


<%@ 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

Supportato in: 4.5, 4, 3.5

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Qualsiasi membro pubblico static (Shared in Visual Basic) di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft. Tutti i diritti riservati.