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.
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 -> intProtected Overridable Function ExecuteInsert (values As IDictionary) As IntegerParamè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.
