DataSourceView.ExecuteInsert(IDictionary) DataSourceView.ExecuteInsert(IDictionary) DataSourceView.ExecuteInsert(IDictionary) DataSourceView.ExecuteInsert(IDictionary) Method

Definizione

Esegue un'operazione di inserimento sull'elenco di dati rappresentato dall'oggetto DataSourceView.Performs an insert operation on the list of data that the DataSourceView object represents.

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 IDictionary IDictionary IDictionary

Insieme IDictionary delle coppie nome/valore utilizzate durante un'operazione di inserimento.An IDictionary of name/value pairs used during an insert operation.

Restituisce

Il numero di elementi inseriti nell'archivio dati sottostante.The number of items that were inserted into the underlying data storage.

Eccezioni

Esempi

Nell'esempio di codice seguente viene illustrato il modo in cui DataSourceView una classe che estende CanInsert la classe può ExecuteInsert eseguire l'override della proprietà e del metodo.The following code example demonstrates how a class that extends the DataSourceView class can override the CanInsert property and the ExecuteInsert method. Questo esempio di codice fa parte di un esempio più ampio fornito DataSourceView per la classe.This code example is part of a larger example provided for the DataSourceView class.

// 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 con associazione a dati possono determinare ExecuteInsert se l'operazione è supportata da un controllo origine dati recuperando DataSourceView l'oggetto usando GetView il metodo e controllando CanInsert la proprietà.Data-bound controls can determine whether the ExecuteInsert operation is supported by a data source control by retrieving the DataSourceView object using the GetView method, and checking the CanInsert property.

Il values parametro è un set di coppie nome/valore che rappresenta le colonne di dati o i campi e i valori corrispondenti da inserire.The values parameter is a set of name/value pairs that represents data columns or fields and corresponding values to insert.

Nota

L' DataSourceView implementazione predefinita della classe consiste nel generare un' NotSupportedException eccezione.The DataSourceView class's default implementation is to throw a NotSupportedException exception. Se si estende la DataSourceView classe, eseguire l' ExecuteInsert override del metodo se la classe supporta l'inserimento nell'archivio dati sottostante.If you extend the DataSourceView class, override the ExecuteInsert method if your class supports insertion into the underlying data storage.

Si applica a

Vedi anche