(String, String, XmlFormOpenMode) del método XmlFormCollection.NewFromFormTemplate
Crea un nuevo formulario usando la plantilla de formulario con datos especificados por un objeto XPathNavigator y abierta en el XmlFormOpenMode especificado.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Function NewFromFormTemplate ( _
formTemplateLocation As String, _
xmlData As String, _
behavior As XmlFormOpenMode _
) As XmlForm
'Uso
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As String
Dim behavior As XmlFormOpenMode
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
xmlData, behavior)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation,
string xmlData,
XmlFormOpenMode behavior
)
Parámetros
formTemplateLocation
Tipo: System.StringIdentificador uniforme de recursos (URI) de la plantilla de formulario en que se va a basar el nuevo formulario.
xmlData
Tipo: System.StringIdentificador uniforme de recursos (URI) del documento XML que proporciona los datos XML que se van a usar como plantilla para el formulario.
behavior
Tipo: Microsoft.Office.InfoPath.XmlFormOpenModeEnumeración XmlFormOpenMode que especifica cómo se abrirá el formulario.
Valor devuelto
Tipo: Microsoft.Office.InfoPath.XmlForm
Objeto XmlForm que representa el nuevo formulario que se ha creado.
Excepciones
| Excepción | Condición |
|---|---|
| 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. |
| ArgumentNullException | El parámetro que se ha pasado a este método es una referencia null (Nothing en Visual Basic). |
| FileNotFoundException | El archivo especificado para formTemplateLocation no existe. |
| InvalidOperationException | Este método fue llamado desde un controlador de eventos para el evento Loading. |
Comentarios
El método NewFromFormTemplate únicamente se puede usar para crear un formulario nuevo a partir de una plantilla de formulario existente; no se puede usar para crear un formulario nuevo a partir de un formulario. Para crear un formulario a partir de un formulario existente, use el método New.
Al usar el método NewFromFormTemplate, el nuevo formulario se abrirá en InfoPath, listo para ser rellenado.
Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.
Ú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 de código, se pasa al método NewFromFormTemplate(formTemplateLocation, xmlData,behavior) de la clase XmlFormCollection el identificador URI de una plantilla de formulario existente, el identificador URI de los datos XML, una enumeración XmlFormOpenMode y se devuelve el objeto XmlForm asociado al nuevo formulario.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", @"C:\MyForm.xml",
XmlFormOpenMode.FailOnVersionOlder);
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", XmlFormOpenMode.FailOnVersionOlder)