XmlFormCollection.NewFromFormTemplateWithInputParameters-Methode

Artikel
05/05/2015

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

Eines oder mehrere durch das kaufmännische Und-Zeichen (&) getrennte Name/Wert-Paare.

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

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".

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")

Siehe auch

Referenz

XmlFormCollection Klasse

XmlFormCollection-Member

Microsoft.Office.InfoPath-Namespace

Freigeben über