Application.CacheFormTemplate-Methode

Artikel
04/27/2010

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
Gibt den URI (Uniform Resource Identifier) der Formularvorlage an. Dieser Parameter kann als Formulardefinitionsdatei (XSF) oder als Formularvorlagendatei (XSN) angegeben werden.

Ausnahmen

Ausnahmetyp	Bedingung
FileNotFoundException	Die Formularvorlagendatei kann nicht gefunden werden.
ArgumentNullException	Der an diese Methode übergebene Parameter ist null.
ArgumentException	Der an diese Methode übergebene Parameter ist ungültig. Er weist z. B. 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 "Using Libraries from Partially Trusted Code" (in Englisch) auf MSDN.

Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

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);
   }
}

.NET Framework-Sicherheit

FileIOPermission Zum Lesen aus dem für formTemplateLocation angegebenen Wert. Verknüpfte Enumerationen: System.Security.Permissions.FileIOPermissionAccess.Read
FileIOPermission Zum Schreiben in das Formularvorlagen-Cacheverzeichnis. Verknüpfte Enumerationen: System.Security.Permissions.RegistryPermissionAccess.Write

Siehe auch

Referenz

Application-Klasse
Application-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über