ObjectDataSource.Delete Método
Definição
Executa uma operação de exclusão, chamando o método identificado pela propriedade DeleteMethod com os parâmetros que estão na coleção DeleteParameters.Performs a delete operation by calling the method that is identified by the DeleteMethod property with any parameters that are in the DeleteParameters collection.
public:
int Delete();
public int Delete ();
member this.Delete : unit -> int
Public Function Delete () As Integer
Retornos
Um valor que representará o número de linhas excluídas do armazenamento de dados subjacente se a propriedade AffectedRows do ObjectDataSourceStatusEventArgs for definida no evento Deleted, caso contrário, -1.A value that represents the number of rows deleted from the underlying data storage, if the AffectedRows property of the ObjectDataSourceStatusEventArgs is set in the Deleted event; otherwise, -1.
Comentários
Antes que a Delete operação seja executada, o OnDeleting método é chamado para gerar o Deleting evento.Before the Delete operation is performed, the OnDeleting method is called to raise the Deleting event. Você pode manipular o Deleting evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma Delete operação.You can handle the Deleting event to examine the values of the parameters and to perform any preprocessing before a Delete operation. Para executar uma operação de exclusão, o ObjectDataSourceView objeto usa a reflexão para criar uma instância do objeto que é identificado pela TypeName propriedade.To perform a delete operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Em seguida, ele chama o método que é identificado pela DeleteMethod propriedade, usando qualquer DeleteParameters propriedade associada.It then calls the method that is identified by the DeleteMethod property, using any associated DeleteParameters properties. Se os parâmetros de exclusão forem provenientes de um controle ligado a dados associado, o nome dos parâmetros será criado de acordo com a OldValuesParameterFormatString propriedade.If the deletion parameters come from an associated data-bound control, the name of the parameters is created according to the OldValuesParameterFormatString property. Após a Delete conclusão da operação, o OnDeleted método é chamado para gerar o Deleted evento.After the Delete operation completes, the OnDeleted method is called to raise the Deleted event. Você pode manipular o Deleted evento para examinar quaisquer valores de retorno, parâmetros de saída e exceções e executar qualquer pós-processamento.You can handle the Deleted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.
O Delete método delega para o Delete método do ObjectDataSourceView objeto que está associado ao ObjectDataSource controle.The Delete method delegates to the Delete method of the ObjectDataSourceView object that is associated with the ObjectDataSource control.
Controles de Data-BoundData-Bound Controls
Quando o ObjectDataSource controle é associado a um controle de vinculação de dados, como o GridView controle, não é necessário chamar o Delete método do código de página.When the ObjectDataSource control is associated with a data-bound control, such as the GridView control, it is not necessary to call the Delete method from page code. O Delete método é invocado diretamente pelo controle associado a dados.The Delete method is invoked directly by the data-bound control instead.
Para obter mais informações sobre a mesclagem de parâmetros, o tempo de vida do objeto e a resolução do método, consulte DeleteMethod .For more information about parameter merging, object lifetime, and method resolution, see DeleteMethod.
Aplica-se a
Confira também
- DeleteMethod
- DeleteParameters
- {1>Controles de servidor Web de fonte de dados<1}Data Source Web Server Controls
- Visão geral do controle ObjectDataSourceObjectDataSource Control Overview
- {1>Criando um objeto de origem de controle ObjectDataSource<1}Creating an ObjectDataSource Control Source Object