DataSourceView.ExecuteInsert(IDictionary) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Wykonuje operację wstawiania na liście danych reprezentowanych przez DataSourceView obiekt.

protected:
 virtual int ExecuteInsert(System::Collections::IDictionary ^ values);

protected virtual int ExecuteInsert (System.Collections.IDictionary values);

abstract member ExecuteInsert : System.Collections.IDictionary -> int
override this.ExecuteInsert : System.Collections.IDictionary -> int

Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer

Parametry

values

IDictionary

Para IDictionary nazwa/wartość używana podczas operacji wstawiania.

Zwraca

Int32

Liczba elementów wstawionych do bazowego magazynu danych.

Wyjątki

NotSupportedException

Operacja nie jest obsługiwana ExecuteInsert(IDictionary) przez element DataSourceView.

Przykłady

W poniższym przykładzie kodu pokazano, jak klasa rozszerzająca DataSourceView klasę może zastąpić CanInsert właściwość i metodę ExecuteInsert . Ten przykład kodu jest częścią większego przykładu udostępnionego DataSourceView dla klasy .

// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
    get {
        return false;
    }
}
protected override int ExecuteInsert(IDictionary values)
{
    throw new NotSupportedException();
}

' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteInsert

Uwagi

Kontrolki powiązane z danymi mogą określać, ExecuteInsert czy operacja jest obsługiwana przez kontrolkę źródła danych, pobierając DataSourceView obiekt przy użyciu GetView metody i sprawdzając CanInsert właściwość .

Parametr values jest zestawem par nazwa/wartość, które reprezentują kolumny danych lub pola i odpowiadające im wartości do wstawienia.

Uwaga

Domyślna DataSourceView implementacja klasy to zgłoszenie wyjątku NotSupportedException . Jeśli rozszerzysz klasę DataSourceView , przesłoń metodę ExecuteInsert , jeśli klasa obsługuje wstawianie do bazowego magazynu danych.

Zobacz też

• CanInsert