Partager via

Application.RegisterFormTemplate, méthode (String, String)

  • Article

Installe le modèle de formulaire spécifié en proposant de remplacer l'enregistrement d'inscription précédent pour le modèle de formulaire.

Espace de noms :  Microsoft.Office.InfoPath
Assembly :  Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)

Syntaxe

'Déclaration
Public MustOverride Sub RegisterFormTemplate ( _
    formTemplateLocation As String, _
    behavior As String _
)
'Utilisation
Dim instance As Application
Dim formTemplateLocation As String
Dim behavior As String

instance.RegisterFormTemplate(formTemplateLocation, _
    behavior)

public abstract void RegisterFormTemplate(
    string formTemplateLocation,
    string behavior
)

Paramètres

  • formTemplateLocation
    Type : System.String
    Indique l'URL (Uniform Resource Locator) du modèle de formulaire. Ce paramètre peut être spécifié en tant que fichier de définition de formulaire (.xsf) ou fichier modèle de formulaire (.xsn).
  • behavior
    Type : System.String
    Indique comment le modèle de formulaire doit être installé. La valeur par défaut est « overwrite ». La seule autre valeur valide pour ce paramètre est « new-only ».

Exceptions

Exception Condition
FileNotFoundException

Le fichier de modèle de formulaire est introuvable.
ArgumentNullException

Les paramètres transmis à cette méthode sont une référence NULL (Nothing dans Visual Basic).
ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.

Remarques

Si le modèle de formulaire est déjà inscrit et si vous indiquez « new-only » pour le paramètre behavior, la méthode RegisterFormTemplate renvoie une erreur. Si vous indiquez « overwrite », l'enregistrement d'inscription du modèle de formulaire est remplacé.

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.

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 ci-dessous, la méthode RegisterFormTemplate de la classe Application est utilisée dans une fonction pour installer un modèle de formulaire. Cet exemple part du principe qu'une instruction using ou Imports pour l'espace de noms Microsoft.Office.InfoPath est présente dans la section des déclarations de la classe qui contient la fonction et que la bibliothèque de types Microsoft InfoPath 3.0 est référencée sous l'onglet COM de la boîte de dialogue Ajouter une référence dans Visual Studio.

public void InstallForm()
{
Microsoft.Office.InfoPath.Application infoPathApp = 
   new Microsoft.Office.InfoPath.Application();
infoPathApp.RegisterFormTemplate(@"C:\My Forms\MyFormTemplate.xsn", 
   "overwrite");
}

Public Sub InstallForm()
Dim infoPathApp As Microsoft.Office.InfoPath.Application = _
   new Microsoft.Office.InfoPath.Application()
infoPathApp.RegisterFormTemplate("C:\My Forms\MyFormTemplate.xsn", _
   "overwrite")
End Sub

Autorisations

Voir aussi

Référence

Application Classe

Application, membres

RegisterFormTemplate, surcharge

Microsoft.Office.InfoPath, espace de noms