DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definicja

Wykonuje operację aktualizacji na liście danych reprezentowanych przez DataSourceView 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

Obiekt IDictionary lub klucze wiersza do zaktualizowania przez operację aktualizacji.

values
IDictionary

Para IDictionary nazwa/wartość reprezentująca elementy danych i ich nowe wartości.

oldValues
IDictionary

Para IDictionary nazwa/wartość reprezentująca elementy danych i ich oryginalne wartości.

Zwraca

Int32

Liczba elementów zaktualizowanych w bazowym magazynie danych.

Wyjątki

Przykłady

W poniższym przykładzie kodu pokazano, jak klasa rozszerzająca DataSourceView klasę może zastąpić CanUpdate właściwość i metodę ExecuteUpdate . Ten przykład kodu jest częścią większego przykładu udostępnionego 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ć, ExecuteUpdate czy operacja jest obsługiwana przez kontrolkę źródła danych przy użyciu DataSourceControl.GetView metody pobierania DataSourceView obiektu i sprawdzania CanUpdate wartości właściwości.

Parametr keys reprezentuje obiekt lub klucze wierszy danych do zaktualizowania. W przypadku źródeł danych reprezentujących dane relacyjne, takich jak kontrolka SqlDataSource , keys parametr jest kolekcją kluczy podstawowych bazy danych. W innych scenariuszach keys parametr jest kolekcją par nazwa/wartość 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 nazwa/wartość reprezentująca nowe wartości dla istniejących pól lub kolumn.

Uwaga

Domyślna DataSourceView implementacja klasy to zgłoszenie wyjątku NotSupportedException . Jeśli rozszerzysz klasę DataSourceView , przesłoń metodę ExecuteUpdate , jeśli klasa obsługuje aktualizowanie danych w bazowym magazynie danych.

Dotyczy

Zobacz też