XmlFormCollection.NewFromFormTemplateWithInputParameters, méthode
Crée un formulaire à partir du modèle de formulaire et des paramètres d'entrée spécifiés.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Function NewFromFormTemplateWithInputParameters ( _
formTemplateLocation As String, _
inputParameters As String _
) As XmlForm
'Utilisation
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
)
Paramètres
- formTemplateLocation
Type : System.String
L'URI (Uniform Resource Identifier) du modèle de formulaire sur lequel baser le nouveau formulaire.
- inputParameters
Type : System.String
Une ou plusieurs paires nom/valeur séparées par une esperluette (&).
Valeur de retour
Type : Microsoft.Office.InfoPath.XmlForm
Un objet qui représente le nouveau formulaire.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect. |
| ArgumentNullException | Le paramètre passé à cette méthode est une référence NULL (Nothing dans Visual Basic). |
| FileNotFoundException | Le fichier spécifié pour formTemplateLocation n'existe pas. |
| InvalidOperationException | Cette méthode a été appelée depuis un gestionnaire d'événements pour l'événement Loading. |
Remarques
Pour utiliser les paramètres d'entrée passés au paramètre inputParameters, le formulaire spécifié dans le paramètre formTemplateLocation doit contenir un gestionnaire d'événements Loading qui utilise la propriété InputParameters de la classe LoadingEventArgs pour récupérer les valeurs des paramètres d'entrée et traiter ces valeurs. Pour consulter un exemple sur la façon de procéder, voir la rubrique sur la propriété InputParameters.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Ce membre est accessible uniquement par les formulaires ouverts à partir d’un modèle de formulaire configuré pour être exécuté avec des autorisations totales à l’aide de la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire. Ce membre nécessite une autorisation totale pour l’appelant immédiat et ne peut pas être utilisé par un code partiellement fiable. Pour plus d’informations, voir « Using Libraries from Partially Trusted Code » (« Utilisation de bibliothèques à partir de code partiellement fiable ») (éventuellement en anglais) sur MSDN.
Exemples
L'exemple de code suivant montre comment créer un formulaire en passant l'URI d'un modèle de formulaire qui contient un gestionnaire d'événements Loading approprié, et deux paramètres d'entrée.
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")