Udostępnij za pośrednictwem


SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Metoda

Definicja

Wykonuje operację usuwania przy użyciu DeleteCommand ciągu SQL, wszystkich parametrów określonych w DeleteParameters kolekcji oraz wartości, które znajdują się w określonych keys kolekcjach i oldValues .

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

Parametry

keys
IDictionary

Wartość IDictionary klucza obiektu lub wiersza dla ExecuteDelete(IDictionary, IDictionary) operacji do usunięcia.

oldValues
IDictionary

Element IDictionary zawierający wartości wierszy, które są oceniane tylko wtedy, gdy ConflictDetection właściwość jest ustawiona na CompareAllValues wartość.

Zwraca

Wartość reprezentująca liczbę wierszy usuniętych z bazowej bazy danych.

Wyjątki

Nie SqlDataSource można nawiązać połączenia z bazowym źródłem danych.

-lub-

Właściwość jest ustawiona ConflictDetectionCompareAllValues na wartość i nie są przekazywane żadne oldValues parametry.

Bieżący użytkownik nie ma odpowiednich uprawnień dostępu do bazy danych.

-lub-

Wystąpienie kontrolki jest kontrolką AccessDataSource i odmowa dostępu do ścieżki DataFile określonej dla właściwości.

Właściwość CanDelete to false.

-lub-

Ścieżka względna czasu projektowania nie została poprawnie zamapowana przez projektanta przed użyciem wystąpienia kontrolki AccessDataSource .

Uwagi

Klasa SqlDataSourceView implementuje dziedziczona ExecuteDelete metodę w celu usunięcia danych z bazy danych. Deweloperzy stron i autorzy kontrolek powiązanych z danymi nie nazywają ExecuteDelete metody bezpośrednio. Zamiast tego należy użyć publicznie uwidocznionej Delete metody.

Wartości zawarte w keys kolekcji są oceniane i scalane z dowolnymi wartościami zawartymi w kolekcji DeleteParameters . ConflictDetection Jeśli właściwość jest ustawiona CompareAllValues na wartość, wartości zawarte w oldValues kolekcji są formatowane za OldValuesParameterFormatString pomocą właściwości i są również scalane.

Przed wykonaniem operacji usuwania wywoływana OnDeleting jest metoda w celu wywołania Deleting zdarzenia. To zdarzenie można obsłużyć w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed usunięciem.

Aby wykonać operację usuwania, SqlDataSourceView obiekt kompiluje DbCommand obiekt przy użyciu DeleteCommand tekstu i wszelkich skojarzonych DeleteParameters właściwości, a następnie wykonuje DbCommand obiekt względem bazowej bazy danych. Po zakończeniu operacji usuwania wywoływana OnDeleted jest metoda w celu wywołania Deleted zdarzenia. To zdarzenie można obsłużyć w celu zbadania wszystkich zwracanych wartości i kodów błędów oraz wykonania dowolnego przetwarzania końcowego.

Dotyczy

Zobacz też