ObjectDataSource.Insert Metodo

Definizione

Esegue un'operazione di inserimento chiamando il metodo identificato dalla proprietà InsertMethod e dai parametri nell'insieme InsertParameters.Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

public:
 int Insert();
public int Insert ();
member this.Insert : unit -> int
Public Function Insert () As Integer

Restituisce

Valore che rappresenta il numero di righe inserite nell'archivio dati sottostante.A value that represents the number of rows inserted into the underlying data storage.

Commenti

Prima di Insert eseguire l'operazione, viene OnInserting chiamato il metodo per generare l' Inserting evento.Before the Insert operation is performed, the OnInserting method is called to raise the Inserting event. È possibile gestire l' Inserting evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un' Insert operazione.You can handle the Inserting event to examine the values of the parameters and to perform any preprocessing before an Insert operation. Per eseguire un'operazione di inserimento, ObjectDataSourceView l'oggetto utilizza la reflection per creare un'istanza dell'oggetto identificato TypeName dalla proprietà.To perform an insert operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Viene quindi chiamato il metodo identificato dalla InsertMethod proprietà, utilizzando le proprietà associate. InsertParametersIt then calls the method that is identified by the InsertMethod property, using any associated InsertParameters properties. Al termine Insert dell'operazione, viene chiamato OnInserted il metodo per generare l' Inserted evento.After the Insert operation completes, the OnInserted method is called to raise the Inserted event. È possibile gestire l' Inserted evento per esaminare i valori restituiti, i parametri di output e le eccezioni e per eseguire qualsiasi post-elaborazione.You can handle the Inserted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

Il Insert metodo delega Insert al metodo dell' ObjectDataSourceView oggetto associato ObjectDataSource al controllo.The Insert method delegates to the Insert method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Per ulteriori informazioni sull'Unione di parametri, sulla durata degli oggetti e sulla risoluzione InsertMethoddei metodi, vedere.For more information about parameter merging, object lifetime, and method resolution, see InsertMethod.

Controlli con associazione a datiData-Bound Controls

Quando l' ObjectDataSource oggetto è associato a un controllo con associazione a dati, ad esempio GridView il controllo, non è necessario chiamare il Insert metodo dal codice della pagina.When the ObjectDataSource object is associated with a data-bound control, such as the GridView control, it is not necessary to call the Insert method from page code. Il Insert metodo viene invece richiamato direttamente dal controllo con associazione a dati.The Insert method is invoked directly by the data-bound control instead.

Si applica a

Vedi anche