ListViewUpdateEventArgs.NewValues Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.IOrderedDictionaryPublic ReadOnly Property NewValues As IOrderedDictionaryValeur 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é .
