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é

IOrderedDictionary

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 à insérer pour l’enregistrement. Par exemple, vous pouvez valider ou encoder html les valeurs de l’enregistrement avant d’être insérées 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

En guise de 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 directement des valeurs de champ. Les contrôles de source de données qui s’appuient sur l’ordre des champs (par exemple AccessDataSource) peuvent accéder aux valeurs de champ uniquement par index.

S’applique à

Voir aussi