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 nell'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 -> int
Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer
Parametri
- values
- IDictionary
Oggetto IDictionary di coppie nome/valore utilizzate durante un'operazione di inserimento.
Restituisce
Numero di elementi inseriti nell'archivio dati sottostante.
Eccezioni
L'operazione ExecuteInsert(IDictionary) non è supportata da DataSourceView.
Esempio
Nell'esempio di codice seguente viene illustrato come una classe che estende la classe può eseguire l'override DataSourceView della CanInsert proprietà e del ExecuteInsert metodo . Questo esempio di codice fa parte di un esempio più ampio 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 a dati possono determinare se l'operazione ExecuteInsert è supportata da un controllo origine dati recuperando l'oggetto DataSourceView usando il GetView metodo e controllando la CanInsert proprietà .
Il values parametro è un set di coppie nome/valore che rappresenta colonne di dati o campi e valori corrispondenti da inserire.
Annotazioni
L'implementazione DataSourceView predefinita della classe consiste nel generare un'eccezione NotSupportedException . Se si estende la classe, eseguire l'override DataSourceView del metodo se la classe supporta l'inserimento ExecuteInsert nell'archivio dati sottostante.