XmlFormCollection.NewFromFormTemplateWithInputParameters Methode

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein neues Formular mit der angegebenen Formularvorlage und den angegebenen Eingabeparametern.

public:
 abstract Microsoft::Office::InfoPath::XmlForm ^ NewFromFormTemplateWithInputParameters(System::String ^ formTemplateLocation, System::String ^ inputParameters);

public abstract Microsoft.Office.InfoPath.XmlForm NewFromFormTemplateWithInputParameters (string formTemplateLocation, string inputParameters);

abstract member NewFromFormTemplateWithInputParameters : string * string -> Microsoft.Office.InfoPath.XmlForm

Public MustOverride Function NewFromFormTemplateWithInputParameters (formTemplateLocation As String, inputParameters As String) As XmlForm

Parameter

formTemplateLocation: String

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

inputParameters: String

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

Gibt zurück

XmlForm

Ein Objekt, von dem das neue Formular dargestellt wird. form.

Ausnahmen

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 NULL-Verweis (Nothing in Visual Basic).

FileNotFoundException

Die für formTemplateLocation angegebene Datei ist nicht vorhanden.

InvalidOperationException

Diese Methode wurde von einem Ereignishandler für das Loading -Ereignis aufgerufen.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie ein neues Formular erstellen, 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&amp;Acct=Contoso");

Dim newDocument As XmlForm = _
   Me.Application.XmlForms.NewFromFormTemplateWithParameters( _
   "C:\User Forms\DeptReport.xsn","Dept=Accounting&amp;Acct=Contoso")

Hinweise

Um die Eingabeparameter zu verwenden, die an den inputParameters Parameter übergeben wurden, muss das im formTemplateLocation -Parameter angegebene Formular einen Loading Ereignishandler enthalten, der die InputParameters -Eigenschaft der LoadingEventArgs -Klasse verwendet, um die Eingabeparameterwerte abzurufen und dann etwas mit diesen Werten auszuführen. Ein Beispiel dafür finden Sie im InputParameters Eigenschaftenthema.

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

Gilt für:

Freigeben über