Sdílet prostřednictvím


DataSourceView.ExecuteInsert(IDictionary) Metoda

Definice

Provede operaci vložení v seznamu dat, která DataSourceView objekt představuje.

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

Parametry

values
IDictionary

Dvojice IDictionary název/hodnota použitá během operace vložení

Návraty

Počet položek, které byly vloženy do podkladového úložiště dat.

Výjimky

Příklady

Následující příklad kódu ukazuje, jak třída, která rozšiřuje DataSourceView třídu může přepsat CanInsert vlastnost a metodu ExecuteInsert . Tento příklad kódu je součástí většího příkladu uvedeného pro třídu DataSourceView.

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

Poznámky

Ovládací prvky vázané na data mohou určit, zda ExecuteInsert je operace podporována ovládacím prvek zdroje dat načtením DataSourceView objektu GetView pomocí metody a kontrolou CanInsert vlastnosti.

Parametr values je sada dvojic name/value, které představují datové sloupce nebo pole a odpovídající hodnoty pro vložení.

Poznámka:

Výchozí DataSourceView implementace třídy je vyvolání NotSupportedException výjimky. Pokud třídu rozšíříte DataSourceView , přepište metodu ExecuteInsert , pokud vaše třída podporuje vložení do podkladového úložiště dat.

Platí pro

Viz také