DetailsView.InsertItem(Boolean) Methode

Definition

Fügt den aktuellen Datensatz in der Datenquelle ein.

public:
 virtual void InsertItem(bool causesValidation);
public virtual void InsertItem (bool causesValidation);
abstract member InsertItem : bool -> unit
override this.InsertItem : bool -> unit
Public Overridable Sub InsertItem (causesValidation As Boolean)

Parameter

causesValidation
Boolean

true, wenn beim Aufrufen der Methode eine Seitenvalidierung ausgeführt werden soll, andernfalls false.

Ausnahmen

Diese Methode wird aufgerufen, wenn sich das DetailsView-Steuerelement nicht im Einfügemodus befindet.

- oder -

Die dem DataSourceView-Steuerelement zugeordnete DetailsView ist null.

Hinweise

Wenn sich das DetailsView Steuerelement im Einfügemodus befindet, verwenden Sie die InsertItem -Methode, um den aktuellen Datensatz programmgesteuert in die Datenquelle einzufügen. Diese Methode wird häufig verwendet, wenn Sie den aktuellen Datensatz von außerhalb des DetailsView Steuerelements einfügen müssen, z. B. aus einem anderen Steuerelement auf der Seite.

Hinweis

Das DetailsView Steuerelement muss sich im Einfügemodus befinden, wenn diese Methode aufgerufen wird. Andernfalls wird eine HttpException Ausnahme ausgelöst.

Verwenden Sie den causesValidation -Parameter, um anzugeben, ob die Seitenüberprüfung vor dem Einfügevorgang ausgeführt wird. Beim Aufrufen dieser Methode werden auch die ItemInserted Ereignisse und ItemInserting ausgelöst.

Gilt für:

Weitere Informationen