XmlFormCollection.NewFromFormTemplate, méthode (String)
Crée un nouveau formulaire basé sur le modèle de formulaire et les données facultatives spécifiés.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Function NewFromFormTemplate ( _
formTemplateLocation As String _
) As XmlForm
'Utilisation
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation
)
Paramètres
- formTemplateLocation
Type : System.String
L'URI (Uniform Resource Identifier) du modèle de formulaire sur lequel baser le nouveau formulaire.
Valeur de retour
Type : Microsoft.Office.InfoPath.XmlForm
Objet XmlForm qui représente le nouveau formulaire créé.
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
La méthode NewFromFormTemplate ne peut être utilisée que pour créer un formulaire basé sur un modèle de formulaire existant et non sur un formulaire. Pour créer un formulaire à partir d'un formulaire, utilisez la méthode New.
Lorsque vous utilisez la méthode NewFromFormTemplate, le nouveau formulaire s'ouvre dans InfoPath, prêt à être rempli.
Ce membre est accessible uniquement par les formulaires qui s’exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d’autorisations valables pour plusieurs domaines.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l'exemple suivant, la méthode NewFromFormTemplate(formTemplateLocation) de la classe XmlFormCollection reçoit l'URI d'un modèle de formulaire existant ; l'objet XmlForm associé au nouveau formulaire est renvoyé.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn")