Udostępnij za pośrednictwem


DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definicja

Wykonuje operację aktualizacji na liście danych, które DataSourceView reprezentuje obiekt.

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

Parametry

keys
IDictionary

Klucz IDictionary obiektu lub wiersza, który ma zostać zaktualizowany przez operację aktualizacji.

values
IDictionary

Para IDictionary nazw/wartości reprezentujących elementy danych i ich nowe wartości.

oldValues
IDictionary

Para IDictionary nazw/wartości reprezentujących elementy danych i ich oryginalne wartości.

Zwraca

Liczba elementów, które zostały zaktualizowane w bazowym magazynie danych.

Wyjątki

Przykłady

Poniższy przykład kodu pokazuje, jak klasa, która rozszerza DataSourceView klasę, może zastąpić CanUpdate właściwość i metodę ExecuteUpdate . Ten przykład kodu jest częścią większego przykładu podanego DataSourceView dla klasy.

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

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

End Class

Uwagi

Kontrolki powiązane z danymi mogą określać, czy ExecuteUpdate operacja jest obsługiwana przez kontrolkę źródła danych przy użyciu DataSourceControl.GetView metody pobierania DataSourceView obiektu i sprawdzania wartości CanUpdate właściwości.

Parametr keys reprezentuje obiekt lub klucze wierszy danych do zaktualizowania. W przypadku źródeł danych reprezentujących dane relacyjne, takie jak SqlDataSource kontrolka, keys parametr jest kolekcją kluczy podstawowych bazy danych. W innych scenariuszach keys parametr jest kolekcją par nazw/wartości i służy do filtrowania listy danych. Wszystkie dane pasujące do pary nazwa/wartość są aktualizowane przy użyciu wartości znalezionych w parametrze values , który jest zestawem par nazw/wartości reprezentujących nowe wartości dla istniejących pól lub kolumn.

Uwaga

Domyślna DataSourceView implementacja klasy polega na zgłaszaniu wyjątku NotSupportedException . Jeśli rozszerzysz klasę DataSourceView , zastąpisz ExecuteUpdate metodę, jeśli klasa obsługuje aktualizowanie danych w bazowym magazynie danych.

Dotyczy

Zobacz też