EntityDataSource.Inserting EntityDataSource.Inserting EntityDataSource.Inserting EntityDataSource.Inserting Event

Definition

Tritt ein, bevor ein neues Objekt in der Datenquelle beibehalten wird.Occurs before a new object is persisted to the data source.

public:
 event EventHandler<System::Web::UI::WebControls::EntityDataSourceChangingEventArgs ^> ^ Inserting;
public event EventHandler<System.Web.UI.WebControls.EntityDataSourceChangingEventArgs> Inserting;
member this.Inserting : EventHandler<System.Web.UI.WebControls.EntityDataSourceChangingEventArgs> 
Public Custom Event Inserting As EventHandler(Of EntityDataSourceChangingEventArgs) 

Hinweise

Das Inserting -Ereignis wird ausgelöst, bevor ein neues-Objekt in der Datenquelle persistent gespeichert wird.The Inserting event is raised before a new object is persisted to the data source. Das Inserting -Ereignis ermöglicht es Ihnen, das hinzugefügte Objekt zu ändern oder zu überprüfen, ein anderes Objekt hinzuzufügen oder den Vorgang abzubrechen.The Inserting event enables you to modify or verify the object being added, add a different object, or cancel the operation. Sie können auf das-Objekt zugreifen, das aus Entity der-Eigenschaft EntityDataSourceChangingEventArgs des-Objekts hinzugefügt werden soll.You can access the object to be added from the Entity property of the EntityDataSourceChangingEventArgs object. Wenn ein anderes Objekt bereitgestellt wird, ist der Benutzer verantwortlich für das Festlegen des korrekten Entitäts Typs in der Entity Eigenschaft.If supplying a different object, the user is responsible for setting the correct entity type in the Entity property.

Legen Sie die Cancel -Eigenschaft EntityDataSourceChangingEventArgs des-Objekts auf truefest, um zu verhindern, dass das-Objekt hinzugefügt wird.To stop the object from being added, set the Cancel property of the EntityDataSourceChangingEventArgs object to true.

Wenn beim Erstellen eines neuen Objekts ein Fehler auftritt, wird Inserting das-Ereignis ausgelöst, Exception und die- EntityDataSourceChangingEventArgs Eigenschaft des-Objekts wird auf Exceptionden zurückgegebenen festgelegt.If an error occurs when creating a new object, the Inserting event is raised and the Exception property of the EntityDataSourceChangingEventArgs object is set to the returned Exception.

Wenn Sie die Ausnahme im Inserting -Ereignishandler behandeln, legen Sie die ExceptionHandled - trueEigenschaft auf fest.When you handle the exception in the Inserting event handler, set the ExceptionHandled property to true. Dadurch wird verhindert, dass die Ausnahme erneut ausgelöst wird.This prevents the exception from being raised again. Wenn Sie false für die ExceptionHandled -Eigenschaft den Wert angeben, löst EntityDataSource die Ausnahme erneut aus.When you specify a value of false for the ExceptionHandled property, the EntityDataSource re-raises the exception.

Gilt für: