XmlFormCollection.NewFromFormTemplateWithInputParameters-Methode
Erstellt ein neues Formular mit der angegebenen Formularvorlage und den angegebenen Eingabeparametern.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Function NewFromFormTemplateWithInputParameters ( _
formTemplateLocation As String, _
inputParameters As String _
) As XmlForm
'Usage
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim inputParameters As String
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplateWithInputParameters(formTemplateLocation, _
inputParameters)
public abstract XmlForm NewFromFormTemplateWithInputParameters(
string formTemplateLocation,
string inputParameters
)
Parameter
- formTemplateLocation
Typ: System.String
Der URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.
- inputParameters
Typ: System.String
Mindestens ein Name-Wert-Paar mit kaufmännischem Und-Zeichen (&) als Trennzeichen.
Rückgabewert
Typ: Microsoft.Office.InfoPath.XmlForm
Ein Objekt, von dem das neue Formular dargestellt wird. form.
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
Damit die Eingabeparameter verwendet werden, die an den inputParameters-Parameter übergeben wurden, muss das im formTemplateLocation-Parameter angegebene Formular einen Loading-Ereignishandler enthalten, der mithilfe der InputParameters-Eigenschaft der LoadingEventArgs-Klasse die Eingabeparameterwerte abruft, und dann diese Werte in irgendeiner Weise verwenden. Ein Beispiel hierfür finden Sie im Thema zur InputParameters-Eigenschaft.
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.
Auf den Member kann nur über Formulare zugegriffen werden, die über eine Formularvorlage geöffnet werden. Die Formularvorlage muss zum voll vertrauenswürdigen Ausführen mithilfe der Kategorie Sicherheit und Vertrauensstellung des Dialogfelds Formularoptionen konfiguriert werden. Der Member erfordert volle Vertrauenswürdigkeit für den sofortigen Aufrufer und kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code" auf MSDN.
Beispiele
Das folgende Codebeispiel zeigt, wie Sie ein neues Formular erstellen können, indem Sie den URI einer Formularvorlage übergeben, die einen entsprechenden Loading-Ereignishandler und zwei Eingabeparameter enthält.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplateWithParameters(
@"C:\User Forms\DeptReport.xsn","Dept=Accounting&Acct=Contoso");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplateWithParameters( _
"C:\User Forms\DeptReport.xsn","Dept=Accounting&Acct=Contoso")