XmlFormCollection.NewFromFormTemplate, méthode (String, String, XmlFormOpenMode)
Crée un formulaire à l'aide du modèle de formulaire spécifié, avec les données spécifiées par un objet XPathNavigator et ouvert selon le mode XmlFormOpenModespécifié.
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, _
xmlData As String, _
behavior As XmlFormOpenMode _
) As XmlForm
'Utilisation
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As String
Dim behavior As XmlFormOpenMode
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
xmlData, behavior)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation,
string xmlData,
XmlFormOpenMode behavior
)
Paramètres
- formTemplateLocation
Type : System.String
L'URI (Uniform Resource Identifier) du modèle de formulaire sur lequel baser le nouveau formulaire.
- xmlData
Type : System.String
L'URI (Uniform Resource Identifier) du document XML qui fournit les données XML à utiliser comme modèle pour le formulaire.
- behavior
Type : Microsoft.Office.InfoPath.XmlFormOpenMode
Énumération XmlFormOpenMode qui spécifie la technique d'ouverture du 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, xmlData,behavior) de la classe XmlFormCollection reçoit l'URI d'un modèle de formulaire existant, l'URI des données XML et une énumération XmlFormOpenMode ; l'objet XmlForm associé au nouveau formulaire est renvoyé.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", @"C:\MyForm.xml",
XmlFormOpenMode.FailOnVersionOlder);
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", XmlFormOpenMode.FailOnVersionOlder)