DataSourceView.ExecuteDelete(IDictionary, IDictionary) Metoda

Definice

Provede operaci odstranění v seznamu dat, která DataSourceView objekt představuje.

protected:
 virtual int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
abstract member ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Parametry

keys
IDictionary

Operace IDictionary odstraní klíč objektu ExecuteDelete(IDictionary, IDictionary) nebo řádku.

oldValues
IDictionary

Dvojice IDictionary názvů a hodnot, které představují datové prvky a jejich původní hodnoty.

Návraty

Int32

Počet položek, které byly odstraněny z 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 CanDelete vlastnost a metodu ExecuteDelete . Tento příklad kódu je součástí většího příkladu zadaného DataSourceView pro třídu.

// The CsvDataSourceView does not currently
// permit deletion. You can modify or extend
// this sample to do so.
public override bool CanDelete {
    get {
        return false;
    }
}
protected override int ExecuteDelete(IDictionary keys, IDictionary values)
{
    throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit deletion. You can modify or extend
' this sample to do so.
Public Overrides ReadOnly Property CanDelete() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function ExecuteDelete(keys As IDictionary, values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteDelete

Poznámky

Ovládací prvky vázané na data můžou určit, zda ExecuteDelete je operace podporována ovládacím prvek zdroje dat načtením DataSourceView objektu DataSourceControl.GetView pomocí metody a kontrolou CanDelete vlastnosti.

Parametr keys představuje klíč objektu nebo řádku dat k odstranění. U zdrojů dat, které představují relační data, jako SqlDataSource je například ovládací prvek, keys je parametr kolekce primárních klíčů databáze. V jiných scénářích keys je parametr kolekcí párů name/value a slouží k filtrování seznamu dat. Odstraní se všechna data, která odpovídají páru názvů a hodnot.

Poznámka

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

Platí pro

Viz také