XmlForm.New-Eigenschaft
Ruft einen Wert ab, der angibt, ob ein Formular neu ist.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride ReadOnly Property New As Boolean
Get
'Usage
Dim instance As XmlForm
Dim value As Boolean
value = instance.New
public abstract bool New { get; }
Eigenschaftswert
Typ: System.Boolean
true, wenn das Formular neu ist; andernfalls false.
Hinweise
Das Verhalten der New-Eigenschaft ist unterschiedlich, je nachdem, ob das neue Formular mit Microsoft InfoPath 2010 oder in einem Webbrowser erstellt wurde.
In einem Webbrowser wird die New-Eigenschaft beim Erstellen eines neuen Formulars auf true festgelegt. Das Festlegen der Eigenschaft auf false erfolgt nur beim Öffnen eines vorhandenen Formulars.
In InfoPath wird die New-Eigenschaft beim Erstellen eines neuen Formulars auf true, beim erfolgreichen Speichern des Formulars auf false und beim Öffnen eines vorhandenen Formulars auf false festgelegt.
Hinweis
Die New-Eigenschaft entspricht der IsNew-Eigenschaft des XDocument-Objekts im COM/Skript-Objektmodell sowie der IsNew-Eigenschaft der _XDocument2-Benutzeroberfläche des mit InfoPath 2003 kompatiblen Objektmodells mit verwaltetem Code.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Das folgende Codebeispiel zeigt ein Muster für die Verwendung der New-Eigenschaft für die bedingte Ausführung von Code, abhängig davon, ob das Formular neu ist oder nicht.
if (this.New)
{
// Code to run if form is new.
}
else
{
// Code to run if form is not new.
}
If (Me.[New]) Then
' Code to run if form is new.
Else
' Code to run if form is not new.
End If