XmlFormCollection.NewFromFormTemplate-Methode (String, String, XmlFormOpenMode)

Artikel
05/05/2015

Erstellt mithilfe der angegebenen Formularvorlage ein neues Formular mit Daten, die durch ein XPathNavigator-Objekt angegeben werden, und öffnet es im durch XmlFormOpenMode angegebenen Öffnungsmodus.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustOverride Function NewFromFormTemplate ( _
    formTemplateLocation As String, _
    xmlData As String, _
    behavior As XmlFormOpenMode _
) As XmlForm
'Usage
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As String
Dim behavior As XmlFormOpenMode
Dim returnValue As XmlForm

returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
    xmlData, behavior)

public abstract XmlForm NewFromFormTemplate(
    string formTemplateLocation,
    string xmlData,
    XmlFormOpenMode behavior
)

Parameter

formTemplateLocation
Typ: System.String

Der URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.

xmlData
Typ: System.String

Der URI (Uniform Resource Identifier) des XML-Dokuments, das die als Vorlage für das Formular zu verwendenden XML-Daten bereitstellt.

behavior
Typ: Microsoft.Office.InfoPath.XmlFormOpenMode

Eine XmlFormOpenMode-Enumeration, die angibt, wie das Formular geöffnet wird.

Rückgabewert

Typ: Microsoft.Office.InfoPath.XmlForm
Ein XmlForm-Objekt, das das neue Formular darstellt, das erstellt wurde.

Ausnahmen

Ausnahme	Bedingung
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 Parameter, der an diese Methode übergeben wurde, ist ein Nullverweis (Nothing in Visual Basic).
FileNotFoundException	Die für formTemplateLocation angegebene Datei ist nicht vorhanden.
InvalidOperationException	Diese Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen.

Hinweise

Die NewFromFormTemplate -Methode kann nur verwendet werden, um ein neues Formular basierend auf einer vorhandenen Formularvorlage zu erstellen. Die Methode kann nicht verwendet werden, um ein neues Formular basierend auf einem Formular zu erstellen. Zum Erstellen eines Formulars aus einem vorhandenen Formular verwenden Sie die New-Methode.

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

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

Beispiele

Im folgenden Codebeispiel wird der NewFromFormTemplate(formTemplateLocation, xmlData,behavior)-Methode der XmlFormCollection-Klasse der URI einer vorhandenen Formularvorlage, der URI der XML-Daten und eine XmlFormOpenMode-Enumeration übergeben, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.

XmlForm newDocument = 
   this.Application.XmlForms.NewFromFormTemplate(
   @"C:\MyForm.xsn", @"C:\MyForm.xml", 
   XmlFormOpenMode.FailOnVersionOlder);

Dim newDocument As XmlForm  = _
   Me.Application.XmlForms.NewFromFormTemplate(_
   "C:\MyForm.xsn", XmlFormOpenMode.FailOnVersionOlder)

Siehe auch

Referenz

XmlFormCollection Klasse

XmlFormCollection-Member

NewFromFormTemplate-Überladung

Microsoft.Office.InfoPath-Namespace

Freigeben über