DataSourceView.ExecuteInsert(IDictionary) Méthode
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.
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.