DataSourceView.ExecuteInsert(IDictionary) Metod

Definition

Utför en infogningsåtgärd i listan över data som DataSourceView objektet representerar.

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

Parametrar

values
IDictionary

Ett IDictionary namn/värde-par som används under en infogningsåtgärd.

Returer

Antalet objekt som infogades i den underliggande datalagringen.

Undantag

Exempel

Följande kodexempel visar hur en klass som utökar DataSourceView klassen kan åsidosätta CanInsert egenskapen och ExecuteInsert metoden. Det här kodexemplet är en del av ett större exempel för DataSourceView klassen.

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

Kommentarer

Databundna kontroller kan avgöra om ExecuteInsert åtgärden stöds av en datakällakontroll genom att DataSourceView hämta objektet med hjälp av GetView metoden och kontrollera CanInsert egenskapen.

Parametern values är en uppsättning namn/värde-par som representerar datakolumner eller fält och motsvarande värden som ska infogas.

Note

Klassens DataSourceView standardimplementering är att utlösa ett NotSupportedException undantag. Om du utökar DataSourceView klassen åsidosätter ExecuteInsert du metoden om klassen stöder infogning i den underliggande datalagringen.

Gäller för

Se även