FormErrorCollection.Delete Methode

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Überlädt

Delete(FormError)	Löscht das angegebene FormError aus dem -Objekt, das FormErrorCollection dem aktuellen Formular zugeordnet ist.
Delete(String)	Löscht alle FormError Objekte mit dem angegebenen Namen aus dem Objekt, das FormErrorCollection dem aktuellen Formular zugeordnet ist.

Delete(FormError)

Löscht das angegebene FormError aus dem -Objekt, das FormErrorCollection dem aktuellen Formular zugeordnet ist.

public:
 abstract void Delete(Microsoft::Office::InfoPath::FormError ^ formError);

public abstract void Delete (Microsoft.Office.InfoPath.FormError formError);

abstract member Delete : Microsoft.Office.InfoPath.FormError -> unit

Parameter

formError

FormError

Das zu löschende FormError-Objekt.

Ausnahmen

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

Im folgenden Beispiel wird die GetErrors(FormErrorType) -Methode der FormErrorCollection-Klasse verwendet, um ein Array aller benutzerdefinierten Fehler in der Fehlerauflistung des Formulars abzurufen. Anschließend wird die Delete()-formErrorMethode verwendet, um das erste FormError-Objekt im Array aus der Fehlerauflistung des Formulars zu löschen.

FormErrorCollection myErrors = this.Errors;
FormError[] myUserErrors;

// Get all user defined errors.
myUserErrors = myErrors.GetErrors(FormErrorType.UserDefined);

// Delete the first user defined error.
myErrors.Delete(myUserErrors[0]);

Dim myErrors As FormErrorCollection  = Me.Errors
Dim myUserErrors As FormError()

' Get all user defined errors.
myUserErrors = myErrors.GetErrors(FormErrorType.UserDefined)

' Delete the first user defined error.
myErrors.Delete(myUserErrors(0))

Hinweise

Nur Fehler vom Typ ErrorType.UserDefined können aus der Auflistung gelöscht werden. Wenn der angegebene Fehler nicht benutzerdefiniert ist oder sich nicht in der Auflistung befindet, wird eine Ausnahme ausgelöst.

Auf dieses Mitglied kann uneingeschränkt zugegriffen werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Delete(String)

Löscht alle FormError Objekte mit dem angegebenen Namen aus dem Objekt, das FormErrorCollection dem aktuellen Formular zugeordnet ist.

public:
 abstract void Delete(System::String ^ name);

public abstract void Delete (string name);

abstract member Delete : string -> unit

Public MustOverride Sub Delete (name As String)

Parameter

name

String

Der Name des zu löschenden FormError-Objekts.

Ausnahmen

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

Im folgenden Beispiel wird die Delete()-nameMethode verwendet, um den Fehlernamen Field1Error aus dem FormErrorCollection-Objekt zu löschen, das dem aktuellen Formular zugeordnet ist.

this.Errors.Delete("Field1Error"); Me.Errors.Delete("Field1Error")

Hinweise

Alle Fehler des angegebenen Namens werden aus der Auflistung gelöscht (unterschiedlichen Kontextknoten im Formular zugeordnete Fehler können denselben Namen haben). Nur Fehler vom Typ ErrorType.UserDefined können aus der Auflistung gelöscht werden. Wenn der angegebene Fehler nicht benutzerdefiniert ist oder sich nicht in der Auflistung befindet, wird eine Ausnahme ausgelöst.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.