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

Párů IDictionary název/hodnota použitých během operace vložení.

Návraty

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

Výjimky

Operace ExecuteInsert(IDictionary) není podporována nástrojem DataSourceView.

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 DataSourceView pro třídu.

// 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 objektu DataSourceViewGetView pomocí metody a kontrolou CanInsert vlastnosti.

Parametr values je sada dvojic název/hodnota, která představuje datové sloupce nebo pole a odpovídající hodnoty, které se mají vložit.

Poznámka

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

Platí pro

Viz také