DataSourceView.ExecuteInsert(IDictionary) Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Realiza uma operação de inserção na lista de dados que o DataSourceView objeto representa.

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

Parâmetros

values
IDictionary

Um IDictionary dos pares nome/valor usados durante uma operação de inserção.

Devoluções

Int32

O número de itens inseridos no armazenamento de dados subjacente.

Exceções

NotSupportedException

A ExecuteInsert(IDictionary) operação não é suportada pelo DataSourceView.

Exemplos

O exemplo de código seguinte demonstra como uma classe que estende a DataSourceView classe pode sobrepor a CanInsert propriedade e o ExecuteInsert método. Este exemplo de código faz parte de um exemplo maior fornecido para a DataSourceView classe.

// 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

Observações

Os controlos de dados limitados podem determinar se a ExecuteInsert operação é suportada por um controlo de fonte de dados, recuperando o DataSourceView objeto através do GetView método e verificando a CanInsert propriedade.

O values parâmetro é um conjunto de pares nome/valor que representa colunas de dados ou campos e os valores correspondentes a inserir.

Note

A DataSourceView implementação padrão da classe é lançar uma NotSupportedException exceção. Se estenderes a DataSourceView classe, sobrepõe o ExecuteInsert método se a tua classe suportar inserção no armazenamento de dados subjacente.

Aplica-se a

Ver também