DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Int32

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

Wyjątki

NotSupportedException

Operacja nie jest obsługiwana ExecuteUpdate(IDictionary, IDictionary, IDictionary) przez DataSourceViewelement .

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ż

CanUpdate