Compartilhar via


DataSourceView.ExecuteInsert(IDictionary) Método

Definição

Executa uma operação de inserção na lista de dados que o objeto DataSourceView 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 de pares nome-valor usados durante uma operação de inserção.

Retornos

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

Exceções

Não há suporte para a operação ExecuteInsert(IDictionary) pelo DataSourceView.

Exemplos

O exemplo de código a seguir demonstra como uma classe que estende a DataSourceView classe pode substituir 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

Comentários

Os controles associados a dados podem determinar se a ExecuteInsert operação tem suporte de um controle de fonte de dados recuperando o DataSourceView objeto usando o 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 valores correspondentes a serem inseridos.

Observação

A DataSourceView implementação padrão da classe é gerar uma NotSupportedException exceção. Se você estender a DataSourceView classe, substitua o ExecuteInsert método se sua classe der suporte à inserção no armazenamento de dados subjacente.

Aplica-se a

Confira também