(String, XPathNavigator) del método XmlFormCollection.NewFromFormTemplate
Crea un nuevo formulario utilizando la plantilla de formulario con datos especificados por un objeto XPathNavigator.
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 XPathNavigator _
) As XmlForm
'Uso
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As XPathNavigator
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
xmlData)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation,
XPathNavigator xmlData
)
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.Xml.XPath.XPathNavigatorObjeto XPathNavigator que devuelve los datos XML que se van a usar como plantilla para 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 ejemplo siguiente, se pasa al método NewFromFormTemplate(formTemplateLocation, xmlData) de la clase XmlFormCollection el identificador URI de una plantilla de formulario existente y un objeto XPathNavigator que devuelve datos XML y se devuelve el objeto XmlForm asociado al nuevo formulario.
// Create an in-memory XML document.
XmlDocument newDoc = new XmlDocument();
// Load the document with some XML.
newDoc.LoadXml(
"<?xml version=\"1.0\" encoding=\"utf-8\" ?><person><firstName/><lastName/><address/><city/><country/></person>");
// Create an XPathNavigator for the XML file.
XPathNavigator newDocNav = newDoc.CreateNavigator();
// Call NewFromFormTemplate to open new form and load XML.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", newDocNav);
' Create an in-memory XML document.
Dim newDoc As XmlDocument = new XmlDocument()
' Create XML to load.
Dim xmlToLoad As String = "<?xml version=" & Quote & "1.0" & Quote & _
" encoding=" & Quote & "utf-8" & Quote & _
" ?><person><firstName/><lastName/><address/>" & _
"<city/><country/></person>"
' Load the document with some XML.
newDoc.LoadXml(
)
' Create an XPathNavigator for the XML file.
Dim newDocNav As XPathNavigator = newDoc.CreateNavigator()
' Call NewFromFormTemplate to open new form and load XML.
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", newDocNav)