XmlFormCollection.NewFromFormTemplate-Methode (String)
Erstellt ein neues Formular, das auf der angegebenen Formularvorlage basiert, mit optionalen Daten.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Function NewFromFormTemplate ( _
formTemplateLocation As String _
) As XmlForm
'Usage
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation
)
Parameter
formTemplateLocation
Typ: System.StringDer URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.
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)-Methode der XmlFormCollection-Klasse der URI einer vorhandenen Formularvorlage übergeben, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn")