Application.CacheFormTemplate(String) Methode

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Untersucht die Formularvorlage im Cache und aktualisiert sie ggf. von deren Veröffentlichungsort aus.

public:
 abstract void CacheFormTemplate(System::String ^ formTemplateLocation);

public abstract void CacheFormTemplate(string formTemplateLocation);

abstract member CacheFormTemplate : string -> unit

Public MustOverride Sub CacheFormTemplate (formTemplateLocation As String)

Parameter

formTemplateLocation: String

Gibt den URI (Uniform Resource Identifier) der Formularvorlage an. Dieser Parameter kann als Formulardefinitionsdatei (XSF) oder als Formularvorlagendatei (XSN) angegeben werden.

Ausnahmen

FileNotFoundException

Die Formularvorlagendatei kann nicht gefunden werden.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (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.

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

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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für: