DataSourceView.ExecuteInsert(IDictionary) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esegue un'operazione di inserimento sull'elenco di dati rappresentato dall'oggetto DataSourceView.
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 IntegerParametri
- values
- IDictionary
Insieme IDictionary delle coppie nome/valore utilizzate durante un'operazione di inserimento.
Restituisce
Il numero di elementi inseriti nell'archivio dati sottostante.
Eccezioni
L'operazione ExecuteInsert(IDictionary) non è supportata dall'oggetto DataSourceView.
Esempio
Nell'esempio di codice seguente viene illustrato come una classe che estende la DataSourceView classe può eseguire l'override della CanInsert proprietà e del ExecuteInsert metodo. Questo esempio di codice fa parte di un esempio più grande fornito per 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
Commenti
I controlli associati ai dati possono determinare se l'operazione ExecuteInsert è supportata da un controllo origine dati recuperando l'oggetto usando il DataSourceViewGetView metodo e controllando la CanInsert proprietà.
Il values parametro è un set di coppie nome/valore che rappresentano colonne di dati o campi e valori corrispondenti da inserire.
Nota
L'implementazione DataSourceView predefinita della classe consiste nel generare un'eccezione NotSupportedException . Se si estende la classe, eseguire l'override del ExecuteInsert metodo se la DataSourceView classe supporta l'inserimento nell'archiviazione dati sottostante.
