DataSourceView.ExecuteInsert(IDictionary) Metodo

Definizione

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 -> int
Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer

Parametri

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.

Si applica a

Vedi anche