Application.CacheFormTemplate-Methode
Untersucht die Formularvorlage im Cache und aktualisiert sie ggf. von deren Veröffentlichungsort aus.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub CacheFormTemplate ( _
formTemplateLocation As String _
)
'Usage
Dim instance As Application
Dim formTemplateLocation As String
instance.CacheFormTemplate(formTemplateLocation)
public abstract void CacheFormTemplate(
string formTemplateLocation
)
Parameter
- formTemplateLocation
Typ: System.String
Gibt den URI (Uniform Resource Identifier) der Formularvorlage an. Dieser Parameter kann als Formulardefinitionsdatei (XSF) oder als Formularvorlagendatei (XSN) angegeben werden.
Ausnahmen
Ausnahme | Bedingung |
---|---|
FileNotFoundException | Die Formularvorlagendatei kann nicht gefunden werden. |
ArgumentNullException | Der an diese Methode übergebene Parameter ist ein Nullverweis (Nothing in Visual Basic). |
ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Wenn die im Cache zurzeit enthaltene Formularvorlage der Formularvorlage am Veröffentlichungsort entspricht, erfolgt keine Zwischenspeicherung. Wenn sich der Computer im Offlinemodus befindet und das Formular bereits im Cache gespeichert ist, wird der Cache beibehalten und keine Aktualisierung vorgenommen.
Auf den Member kann nur über Formulare zugegriffen werden, die über eine Formularvorlage geöffnet werden. Die Formularvorlage muss zum voll vertrauenswürdigen Ausführen mithilfe der Kategorie Sicherheit und Vertrauensstellung des Dialogfelds Formularoptionen konfiguriert werden. Der Member erfordert volle Vertrauenswürdigkeit für den sofortigen Aufrufer und kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code" auf MSDN.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel durchläuft die benutzerdefinierte CacheMyFormTemplates-Funktion die Position der einzelnen Formularvorlagen, die im Formular-Array angegeben sind, und übergibt diesen Wert an die CacheFormTemplate-Methode zur Überprüfung.
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);
}
}
Berechtigungen
-
Zum Lesen aus dem für formTemplateLocation angegebenen Wert. Verknüpfte Enumerationen: FileIOPermissionAccess.Read
-
Zum Schreiben in das Formularvorlagen-Cacheverzeichnis. Verknüpfte Enumerationen: RegistryPermissionAccess.Write