Partager via


DataSourceView.ExecuteInsert(IDictionary) Méthode

Définition

Effectue une opération d’insertion sur 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

Paires IDictionary nom/valeur utilisées pendant une opération d’insertion.

Retours

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

Exceptions

L’opération ExecuteInsert(IDictionary) n’est pas prise en charge par le 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 DataSourceView à l’aide 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 de données ou des champs et des valeurs correspondantes à insérer.

Note

L’implémentation par défaut de la DataSourceView 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