DetailsView.InsertItem(Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.