Application.CacheFormTemplate, méthode
Examine le modèle de formulaire dans le cache et, si nécessaire, le met à jour à partir de l'emplacement publié du 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 CacheFormTemplate ( _
formTemplateLocation As String _
)
'Utilisation
Dim instance As Application
Dim formTemplateLocation As String
instance.CacheFormTemplate(formTemplateLocation)
public abstract void CacheFormTemplate(
string formTemplateLocation
)
Paramètres
- formTemplateLocation
Type : System.String
Indique l'URI (Uniform Resource Identifier) 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)
Exceptions
Exception | Condition |
---|---|
FileNotFoundException | Le fichier de modèle de formulaire est introuvable. |
ArgumentNullException | Le paramètre passé à cette méthode est une référence NULL (Nothing dans Visual Basic). |
ArgumentException | Le paramètre transmis à cette méthode n'est pas valide (type ou format incorrect, par exemple). |
Remarques
Si le modèle de formulaire existant dans le cache correspond au modèle de formulaire de l'emplacement publié, aucune mise en cache n'est effectuée. Si l'ordinateur est hors connexion et si le formulaire est déjà dans le cache, celui-ci est conservé et aucune mise à jour n'est effectuée.
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 fonction personnalisée CacheMyFormTemplates exécute une boucle dans l'emplacement de chaque modèle de formulaire spécifié dans le tableau forms et transmet cette valeur à la méthode CacheFormTemplate à des fins d'évaluation.
private string[] _forms =
{
@"\\MyServer\MyForms\MyForm.xsn",
@"\\MyServer\MyForms\manifest.xsf"
};
private void someFunction()
{
...
CacheMyFormTemplates(_forms);
...
}
private void CacheMyFormTemplates(string[] forms)
{
foreach (string form in forms)
{
this.Application.CacheFormTemplate(form);
}
}
Autorisations
-
Permet de lire la valeur spécifiée pour formTemplateLocation. Énumérations associées : FileIOPermissionAccess.Read
-
Permet d'écrire dans le répertoire de cache du modèle de formulaire. Énumérations associées : RegistryPermissionAccess.Write