Cette documentation est archivée et n’est pas conservée.

GridViewUpdateEventArgs.NewValues, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient un dictionnaire contenant les valeurs révisées des paires nom/valeur du champ ne correspondant pas à une clé dans la ligne à mettre à jour.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public IOrderedDictionary NewValues { get; }
/** @property */
public IOrderedDictionary get_NewValues ()

public function get NewValues () : IOrderedDictionary

Valeur de la propriété

Obtient un objet System.Collections.Specialized.IOrderedDictionary contenant les valeurs révisées des paires nom/valeur du champ ne correspondant pas à une clé dans la ligne à mettre à jour.

Utilisez la propriété NewValues (dictionnaire) pour accéder aux valeurs des champs révisés ne correspondant pas à une clé dans la ligne à mettre à jour.

RemarqueRemarque

Le ou les champs clés primaires ne sont pas inclus dans ce dictionnaire. Pour accéder aux valeurs du ou des champs clés primaires, utilisez la propriété Keys. Pour accéder aux valeurs d'origine des champs ne correspondant pas à une clé dans la ligne, utilisez la propriété OldValues.

La propriété NewValues est automatiquement remplie avec les paires nom/valeur des champs révisés ne correspondant pas à une clé dans la ligne. Une entrée séparée est ajoutée à la propriété NewValues pour chaque champ ne correspondant pas à une clé dans la ligne.

Pour déterminer le nom de champ d'une entrée, utilisez la propriété DictionaryEntry.Key d'un objet System.Collections.DictionaryEntry contenu dans le dictionnaire NewValues. Pour déterminer la valeur d'une entrée, utilisez la propriété DictionaryEntry.Value.

L'exemple suivant montre comment utiliser la propriété NewValues pour coder en HTML toutes les valeurs fournies par l'utilisateur avant de mettre à jour la source de données.


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

<script runat="server">

  void CustomersGridView_RowUpdating(Object sender, GridViewUpdateEventArgs e)
  {
     
    // Iterate through the NewValues collection and HTML encode all 
    // user-provided values before updating the data source.
    foreach (DictionaryEntry entry in e.NewValues)
    {
    
      e.NewValues[entry.Key] = Server.HtmlEncode(entry.Value.ToString());
    
    }
        
  }
       
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView RowUpdating Example</h3>
            
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"
        onrowupdating="CustomersGridView_RowUpdating"  
        runat="server">
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: