XmlFormCollection.NewFromFormTemplate-Methode (String, XPathNavigator)

Artikel
05/05/2015

Erstellt mithilfe der angegebenen Formularvorlage ein neues Formular mit Daten, die durch ein XPathNavigator-Objekt angegeben werden.

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

Syntax

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

returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
    xmlData)

public abstract XmlForm NewFromFormTemplate(
    string formTemplateLocation,
    XPathNavigator xmlData
)

Parameter

formTemplateLocation
Typ: System.String

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

xmlData
Typ: System.Xml.XPath.XPathNavigator

Ein XPathNavigator-Objekt, das die als Vorlage für das Formular zu verwendenden XML-Daten zurückgibt.

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 Beispiel wird der NewFromFormTemplate(formTemplateLocation, xmlData)-Methode der XmlFormCollection-Klasse der URI einer vorhandenen Formularvorlage und ein XPathNavigator-Objekt übergeben, das XML-Daten zurückgibt, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.

// Create an in-memory XML document.
XmlDocument newDoc = new XmlDocument();
// Load the document with some XML.
newDoc.LoadXml(
   "<?xml version=\"1.0\" encoding=\"utf-8\" ?><person><firstName/><lastName/><address/><city/><country/></person>");
// Create an XPathNavigator for the XML file.
XPathNavigator newDocNav = newDoc.CreateNavigator();
// Call NewFromFormTemplate to open new form and load XML.
XmlForm newDocument = 
   this.Application.XmlForms.NewFromFormTemplate(
   @"C:\MyForm.xsn", newDocNav);

' Create an in-memory XML document.
Dim newDoc As XmlDocument = new XmlDocument()
' Create XML to load.
Dim xmlToLoad As String = "<?xml version=" & Quote & "1.0" & Quote & _
   " encoding=" & Quote & "utf-8" & Quote & _
   " ?><person><firstName/><lastName/><address/>" & _
   "<city/><country/></person>"
' Load the document with some XML.
newDoc.LoadXml(
   )
' Create an XPathNavigator for the XML file.
Dim newDocNav As XPathNavigator  = newDoc.CreateNavigator()

' Call NewFromFormTemplate to open new form and load XML.
Dim newDocument As XmlForm  = _
   Me.Application.XmlForms.NewFromFormTemplate(_
   "C:\MyForm.xsn", newDocNav)