XmlFormCollection.NewFromFormTemplate-Methode (String, String)
Erstellt ein neues Formular, das die angegebene Formularvorlage und XML-Datendatei verwendet.
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 _
) As XmlForm
'Usage
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As String
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
xmlData)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation,
string xmlData
)
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.
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. Sie kann nicht verwendet werden, um ein neues Formular basierend auf einem vorhandenen Formular zu erstellen. Um ein Formular aus einem vorhandenen Formular zu erstellen, 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 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 InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird der NewFromFormTemplate(formTemplateLocation, xmlData)-Methode der XmlFormCollection-Klasse der URI einer vorhandenen Formularvorlage und der URI der XML-Daten übergeben, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", @"C:\MyForm.xml");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", "C:\MyForm.xml")