DataSourceView.ExecuteInsert(IDictionary) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Operace ExecuteInsert(IDictionary) není podporována 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 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.