ListViewInsertEventArgs.Values 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 les valeurs de l'enregistrement à insérer.
public:
property System::Collections::Specialized::IOrderedDictionary ^ Values { System::Collections::Specialized::IOrderedDictionary ^ get(); };public System.Collections.Specialized.IOrderedDictionary Values { get; }member this.Values : System.Collections.Specialized.IOrderedDictionaryPublic ReadOnly Property Values As IOrderedDictionaryValeur de propriété
Valeurs de l'enregistrement à insérer.
Exemples
L’exemple suivant montre comment itérer dans la Values collection. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ListViewInsertEventArgs classe .
void ContactsListView_ItemInserting(Object sender, ListViewInsertEventArgs e)
{
// Iterate through the values to verify if they are not empty.
foreach (DictionaryEntry de in e.Values)
{
if (de.Value == null)
{
Message.Text = "Cannot insert an empty value.";
e.Cancel = true;
}
}
}
Sub ContactsListView_ItemInserting(ByVal sender As Object, _
ByVal e As ListViewInsertEventArgs)
' Iterate through the values to verify if they are not empty.
For Each de As DictionaryEntry In e.Values
If de.Value Is Nothing Then
Message.Text = "Cannot insert an empty value."
e.Cancel = True
End If
Next
End Sub
Remarques
Utilisez la Values propriété pour accéder aux valeurs des champs que l’enregistrement doit insérer. Par exemple, vous pouvez valider ou encoder en HTML les valeurs de l’enregistrement avant qu’il ne soit inséré dans la source de données.
La Values propriété retourne un OrderedDictionary objet qui implémente l’interface IOrderedDictionary . L’objet OrderedDictionary contient des DictionaryEntry objets qui représentent les champs de l’enregistrement. Pour accéder aux noms de champs, utilisez la Keys propriété de l’objet OrderedDictionary . Pour accéder aux valeurs de champ, utilisez la Values propriété .
Notes
Comme raccourci, vous pouvez utiliser l’indexeur de l’objet OrderedDictionary pour accéder directement aux valeurs de champ. L’avantage de l’utilisation de l’indexeur est qu’il retourne des valeurs de champ directement. Les contrôles de source de données qui s’appuient sur l’ordre de champ (par AccessDataSourceexemple ) peuvent accéder aux valeurs de champ uniquement par index.
