Partager via


ListViewUpdateEventArgs.NewValues Propriété

Définition

Obtient un dictionnaire qui contient les valeurs révisées de l'élément à mettre à jour.

public:
 property System::Collections::Specialized::IOrderedDictionary ^ NewValues { System::Collections::Specialized::IOrderedDictionary ^ get(); };
public System.Collections.Specialized.IOrderedDictionary NewValues { get; }
member this.NewValues : System.Collections.Specialized.IOrderedDictionary
Public ReadOnly Property NewValues As IOrderedDictionary

Valeur de propriété

Valeurs révisées de l'élément à mettre à jour.

Exemples

L’exemple suivant montre comment utiliser la NewValues propriété pour vérifier que l’utilisateur a fourni toutes les valeurs avant la mise à jour de la source de données. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ListViewUpdateEventArgs classe .

void ContactsListView_ItemUpdating(Object sender, ListViewUpdateEventArgs e)
{
  // Cancel the update operation if any of the fields is empty
  // or null.
  foreach (DictionaryEntry de in e.NewValues)
  {
    // Check if the value is null or empty.
    if (de.Value == null || de.Value.ToString().Trim().Length == 0)
    {
      Message.Text = "Cannot set a field to an empty value.";
      e.Cancel = true;
    }
  }
  
  // Convert the email address to lowercase.
  String emailValue = e.NewValues["EmailAddress"].ToString();
  e.NewValues["EmailAddress"] = emailValue.ToLower();

}
Sub ContactsListView_ItemUpdating(ByVal sender As Object, ByVal e As ListViewUpdateEventArgs)
  
  ' Cancel the update operation if any of the fields is empty
  ' or null.
  For Each de As DictionaryEntry In e.NewValues
    ' Check if the value is null or empty
    If de.Value Is Nothing OrElse de.Value.ToString().Trim().Length = 0 Then
      Message.Text = "Cannot set a field to an empty value."
      e.Cancel = True
    End If
  Next
  
  ' Convert the email address to lowercase.
  Dim emailValue As String = e.NewValues("EmailAddress").ToString()    
  e.NewValues("EmailAddress") = emailValue.ToLower()
  
End Sub

Remarques

Utilisez la NewValues propriété (dictionnaire) pour accéder aux valeurs des champs non clés révisés dans l’élément à mettre à jour.

Notes

Le ou les champs de clé primaire sont inclus dans ce dictionnaire si la ou les valeurs de la clé primaire sont mises à jour. Pour accéder aux valeurs d’origine du ou des champs de clé primaire, utilisez la Keys propriété . Pour accéder aux valeurs d’origine des champs non clés dans l’élément, utilisez la OldValues propriété .

La NewValues propriété est automatiquement remplie avec les paires nom/valeur des champs révisés dans l’élément. Une entrée distincte est ajoutée à la NewValues propriété pour chaque champ de l’élément.

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

S’applique à

Voir aussi