Partager via


ListViewInsertEventArgs.Values Propriété

Définition

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.IOrderedDictionary
Public ReadOnly Property Values As IOrderedDictionary

Valeur 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.

S’applique à

Voir aussi