del método Application.CacheFormTemplate
Examina la plantilla de formulario en la caché y, si es necesario, la actualiza desde la ubicación de publicación de la plantilla de formulario.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Sub CacheFormTemplate ( _
formTemplateLocation As String _
)
'Uso
Dim instance As Application
Dim formTemplateLocation As String
instance.CacheFormTemplate(formTemplateLocation)
public abstract void CacheFormTemplate(
string formTemplateLocation
)
Parámetros
formTemplateLocation
Tipo: System.StringEspecifica el identificador uniforme de recursos (URI) de una plantilla de formularios. Este parámetro puede especificarse como un archivo de definición del formulario (.xsf) o como un archivo de plantilla de formulario (.xsn).
Excepciones
Excepción | Condición |
---|---|
FileNotFoundException | No se encuentra el archivo de plantilla de formulario. |
ArgumentNullException | El parámetro pasado a este método es una referencia null (Nothing en Visual Basic). |
ArgumentException | El parámetro pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido. |
Comentarios
Si la plantilla del formulario que existe actualmente en la caché coincide con la de la ubicación de publicación, no tendrá lugar el almacenamiento en la memoria caché. Si el equipo no está conectado a la red y el formulario ya se encuentra en la memoria caché, se conservará éste y no se producirá la actualización.
Solo se puede acceder a este miembro con formularios abiertos desde una plantilla de formulario que haya sido configurada para ejecutarse con confianza total usando la categoría Seguridad y confianza del cuadro de diálogo Opciones de formulario. Este miembro requiere confianza total para el autor de llamada inmediato y no se puede utilizar en un código de confianza parcial. Si desea más información, consulte "Utilizar bibliotecas de código que no es de plena confianza" en MSDN.
Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.
Ejemplos
En el siguiente ejemplo, la función personalizada CacheMyFormTemplates realiza una operación de bucle por la ubicación de cada plantilla de formulario especificada en la matriz forms y pasa el valor al método CacheFormTemplate para su evaluación.
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);
}
}
Permisos
-
para leer en el valor especificado para formTemplateLocation. Enumeraciones asociadas: FileIOPermissionAccess.Read
-
para escribir en el directorio de la caché de plantillas de formulario. Enumeraciones asociadas: RegistryPermissionAccess.Write