Compartir a través de

Application.RegisterFormTemplate Método

Definición

Espacio de nombres:
Microsoft.Office.InfoPath
Ensamblado:
Microsoft.Office.InfoPath.dll
Ensamblado:
Microsoft.Office.InfoPath.dll

Sobrecargas

RegisterFormTemplate(String)

Instala la plantilla de formulario especificada.
RegisterFormTemplate(String, String)

Instala la plantilla de formulario especificada con la opción de sobrescribir la entrada de registro anterior para la plantilla de formulario.

RegisterFormTemplate(String)

Instala la plantilla de formulario especificada.

public:
 abstract void RegisterFormTemplate(System::String ^ formTemplateLocation);
public abstract void RegisterFormTemplate(string formTemplateLocation);
abstract member RegisterFormTemplate : string -> unit
Public MustOverride Sub RegisterFormTemplate (formTemplateLocation As String)

Parámetros

formTemplateLocation
String

Especifica la dirección URL de la plantilla de formulario. Este parámetro puede especificarse como un archivo de definición del formulario (.xsf) o como un archivo de plantilla de formulario (.xsn).

Excepciones

FileNotFoundException

No se encuentra el archivo de plantilla de formulario.

ArgumentNullException

El parámetro pasado a este método es una referencia nula (Nothing en Visual Basic).

ArgumentException

El parámetro que se ha pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.

Comentarios

Si la plantilla de formulario ya se ha registrado, se sobrescribirá la entrada de registro de la plantilla. Para controlar si se sobrescribe el registro de una plantilla de formulario registrada anteriormente, use el RegisterFormTemplate(String, String) método en su lugar.

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.

Se aplica a

RegisterFormTemplate(String, String)

Instala la plantilla de formulario especificada con la opción de sobrescribir la entrada de registro anterior para la plantilla de formulario.

public:
 abstract void RegisterFormTemplate(System::String ^ formTemplateLocation, System::String ^ behavior);
public abstract void RegisterFormTemplate(string formTemplateLocation, string behavior);
abstract member RegisterFormTemplate : string * string -> unit
Public MustOverride Sub RegisterFormTemplate (formTemplateLocation As String, behavior As String)

Parámetros

formTemplateLocation
String

Especifica la dirección URL de la plantilla de formulario. Este parámetro puede especificarse como un archivo de definición del formulario (.xsf) o como un archivo de plantilla de formulario (.xsn).

behavior
String

Especifica cómo se va a instalar la plantilla de formularios. El valor predeterminado es "overwrite". El único valor alternativo válido para este parámetro es "new-only".

Excepciones

FileNotFoundException

No se encuentra el archivo de plantilla de formulario.

ArgumentNullException

Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).

ArgumentException

Los parámetros que se han pasado a este método no son válidos. Por ejemplo, son de un tipo o formato no válido.

Ejemplos

En el ejemplo siguiente, el método RegisterFormTemplate de la Application clase se usa en una función para instalar una plantilla de formulario. En el ejemplo se supone que hay una instrucción using o Imports para el espacio de nombres Microsoft.Office.InfoPath en la sección de declaraciones de la clase que contiene la función y que se hace referencia a la biblioteca de tipos de Microsoft InfoPath 3.0 en la pestaña COM del cuadro de diálogo Agregar referencia de Visual Studio.

public void InstallForm()
{
Microsoft.Office.InfoPath.Application infoPathApp = 
   new Microsoft.Office.InfoPath.Application();
infoPathApp.RegisterFormTemplate(@"C:\My Forms\MyFormTemplate.xsn", 
   "overwrite");
}

Public Sub InstallForm()
Dim infoPathApp As Microsoft.Office.InfoPath.Application = _
   new Microsoft.Office.InfoPath.Application()
infoPathApp.RegisterFormTemplate("C:\My Forms\MyFormTemplate.xsn", _
   "overwrite")
End Sub

Comentarios

Si la plantilla de formulario ya se ha registrado y se especifica "solo nuevo" para el behavior parámetro , el método RegisterFormTemplate devolverá un error. SI se ha especificado "overwrite", el registro de la plantilla de formulario se anulará.

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.

Se aplica a