Freigeben über


XmlFormCollection.New-Methode (String, XmlFormOpenMode)

Erstellt basierend auf dem angegebenen Formular ein neues Formular mithilfe des angegebenen Öffnungsmodusverhaltens.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Function New ( _
    formLocation As String, _
    behavior As XmlFormOpenMode _
) As XmlForm
'Usage
Dim instance As XmlFormCollection
Dim formLocation As String
Dim behavior As XmlFormOpenMode
Dim returnValue As XmlForm

returnValue = instance.New(formLocation, behavior)
public abstract XmlForm New (
    string formLocation,
    XmlFormOpenMode behavior
)

Parameter

  • formLocation
    Der URI (Uniform Resource Identifier) des Formulars, auf dem das neue Formular basieren soll.
  • behavior
    Eine XmlFormOpenMode-Enumeration, die angibt, wie das Formular geöffnet wird.

Rückgabewert

Ein XmlForm-Objekt, das das neue Formular darstellt, das erstellt wurde.

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Die New-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen.

Hinweise

Die New-Methode kann nur verwendet werden, um ein neues Formular basierend auf einem vorhandenen Formular zu erstellen. Sie kann nicht verwendet werden, um ein neues Formular basierend auf einer Formularvorlage zu erstellen. Um ein Formular von einer Formularvorlage zu erstellen, verwenden Sie die NewFromFormTemplate-Methode.

Wenn Sie die New-Methode verwenden, wird das neue Formular in Microsoft Office InfoPath 2007 geöffnet und kann sofort ausgefüllt werden.

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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

Im folgenden Beispiel wird der New-Methode der XmlFormCollection-Klasse mithilfe des Standardöffnungsmodus der URI eines vorhandenen Formulars übergeben, auf dem das neue Formular basieren soll, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.

XmlForm newDocument = 
   this.Application.XmlForms.New(@"C:\MyForm.xml", 
   XmlFormOpenMode.Default);
Dim newDocument As XmlForm  = _
   Me.Application.XmlForms.New("C:\MyForm.xml", 
   XmlFormOpenMode.Default)

Siehe auch

Referenz

XmlFormCollection-Klasse
XmlFormCollection-Member
Microsoft.Office.InfoPath-Namespace