(String, String) del método Application.RegisterFormTemplate

  • Artículo

Instala la plantilla de formulario especificada con la opción de sobrescribir la entrada de registro anterior para 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 RegisterFormTemplate ( _
    formTemplateLocation As String, _
    behavior As String _
)
'Uso
Dim instance As Application
Dim formTemplateLocation As String
Dim behavior As String

instance.RegisterFormTemplate(formTemplateLocation, _
    behavior)

public abstract void RegisterFormTemplate(
    string formTemplateLocation,
    string behavior
)

Parámetros

  • formTemplateLocation
    Tipo: System.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
    Tipo: System.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

Excepción Condición
FileNotFoundException

No se encuentra el archivo de plantilla de formulario.
ArgumentNullException

Los parámetros pasados a este método son una referencia null (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.

Comentarios

Si la plantilla de formulario ya se ha registrado y se ha especificado "new-only" como valor para el parámetro behavior, el método RegisterFormTemplate devolverá un error. SI se ha especificado "overwirte", 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.

Ejemplos

En el siguiente ejemplo, el método RegisterFormTemplate de la clase Application 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

Permisos

Vea también

Referencia

clase Application

Miembros Application

Sobrecarga RegisterFormTemplate

Espacio de nombres Microsoft.Office.InfoPath