Partager via


DataSourceView.ExecuteInsert(IDictionary) Méthode

Définition

Exécute une opération d'insertion dans la liste des données que l'objet DataSourceView représente.

protected:
 virtual int ExecuteInsert(System::Collections::IDictionary ^ values);
protected virtual int ExecuteInsert (System.Collections.IDictionary values);
abstract member ExecuteInsert : System.Collections.IDictionary -> int
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer

Paramètres

values
IDictionary

IDictionary de paires nom/valeur utilisé lors d'une opération d'insertion.

Retours

Nombre d'éléments insérés dans le stockage des données sous-jacent.

Exceptions

L'opération ExecuteInsert(IDictionary) n'est pas prise en charge par DataSourceView.

Exemples

L’exemple de code suivant montre comment une classe qui étend la DataSourceView classe peut remplacer la CanInsert propriété et la ExecuteInsert méthode. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataSourceView classe .

// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
    get {
        return false;
    }
}
protected override int ExecuteInsert(IDictionary values)
{
    throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteInsert

Remarques

Les contrôles liés aux données peuvent déterminer si l’opération ExecuteInsert est prise en charge par un contrôle de source de données en récupérant l’objet à l’aide DataSourceView de la GetView méthode et en vérifiant la CanInsert propriété.

Le values paramètre est un ensemble de paires nom/valeur qui représente des colonnes ou des champs de données et les valeurs correspondantes à insérer.

Notes

L’implémentation DataSourceView par défaut de la classe consiste à lever une NotSupportedException exception. Si vous étendez la DataSourceView classe, remplacez la ExecuteInsert méthode si votre classe prend en charge l’insertion dans le stockage de données sous-jacent.

S’applique à

Voir aussi