XmlFormCollection.NewFromFormTemplate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| NewFromFormTemplate(String) |
Crea un formulario nuevo a partir de la plantilla de formulario especificada, con datos opcionales. |
| NewFromFormTemplate(String, String) |
Crea un nuevo formulario que utiliza la plantilla de formulario y el archivo de datos XML especificados. |
| NewFromFormTemplate(String, XPathNavigator) |
Crea un nuevo formulario mediante la plantilla de formulario especificada con los datos especificados por un XPathNavigator objeto . |
| NewFromFormTemplate(String, String, XmlFormOpenMode) |
Crea un nuevo formulario mediante la plantilla de formulario especificada con los datos especificados por un XPathNavigator objeto y abierta en el especificado XmlFormOpenMode. |
NewFromFormTemplate(String)
Crea un formulario nuevo a partir de la plantilla de formulario especificada, con datos opcionales.
public:
abstract Microsoft::Office::InfoPath::XmlForm ^ NewFromFormTemplate(System::String ^ formTemplateLocation);
public abstract Microsoft.Office.InfoPath.XmlForm NewFromFormTemplate(string formTemplateLocation);
abstract member NewFromFormTemplate : string -> Microsoft.Office.InfoPath.XmlForm
Public MustOverride Function NewFromFormTemplate (formTemplateLocation As String) As XmlForm
Parámetros
- formTemplateLocation
- String
Identificador uniforme de recursos (URI) de la plantilla de formulario en que se va a basar el nuevo formulario.
Devoluciones
Objeto XmlForm que representa el nuevo formulario que se creó.
Excepciones
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.
El parámetro que se pasó a este método es una referencia nula (Nothing en Visual Basic).
El archivo especificado para formTemplateLocation no existe.
Se llamó a este método desde un controlador de eventos para el Loading evento.
Ejemplos
En el siguiente ejemplo de código, el método NewFromFormTemplate(formTemplateLocation) de la XmlFormCollection clase se pasa el URI de una plantilla de formulario existente y se devuelve el objeto XmlForm asociado al nuevo formulario.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn")
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 New(String, XmlFormOpenMode) método .
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.
Se aplica a
NewFromFormTemplate(String, String)
Crea un nuevo formulario que utiliza la plantilla de formulario y el archivo de datos XML especificados.
public:
abstract Microsoft::Office::InfoPath::XmlForm ^ NewFromFormTemplate(System::String ^ formTemplateLocation, System::String ^ xmlData);
public abstract Microsoft.Office.InfoPath.XmlForm NewFromFormTemplate(string formTemplateLocation, string xmlData);
abstract member NewFromFormTemplate : string * string -> Microsoft.Office.InfoPath.XmlForm
Public MustOverride Function NewFromFormTemplate (formTemplateLocation As String, xmlData As String) As XmlForm
Parámetros
- formTemplateLocation
- String
Identificador uniforme de recursos (URI) de la plantilla de formulario en que se va a basar el nuevo formulario.
- xmlData
- String
Identificador uniforme de recursos (URI) del documento XML que proporciona los datos XML que se van a usar como plantilla para el formulario.
Devoluciones
Objeto XmlForm que representa el nuevo formulario que se creó.
Excepciones
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.
El parámetro que se pasó a este método es una referencia nula (Nothing en Visual Basic).
El archivo especificado para formTemplateLocation no existe.
Se llamó a este método desde un controlador de eventos para el Loading evento.
Ejemplos
En el siguiente ejemplo de código, el método NewFromFormTemplate(formTemplateLocation, xmlData) de la XmlFormCollection clase se pasa el URI de una plantilla de formulario existente, el URI de los datos XML y se devuelve el objeto XmlForm asociado del nuevo formulario.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", @"C:\MyForm.xml");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", "C:\MyForm.xml")
Comentarios
El método NewFromFormTemplate solo se puede usar para crear un nuevo formulario basado en una plantilla de formulario existente; no se puede usar para crear un formulario nuevo basado en un formulario. Para crear un formulario a partir de un formulario existente, use el New(String, XmlFormOpenMode) método .
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.
Se aplica a
NewFromFormTemplate(String, XPathNavigator)
Crea un nuevo formulario mediante la plantilla de formulario especificada con los datos especificados por un XPathNavigator objeto .
public:
abstract Microsoft::Office::InfoPath::XmlForm ^ NewFromFormTemplate(System::String ^ formTemplateLocation, System::Xml::XPath::XPathNavigator ^ xmlData);
public abstract Microsoft.Office.InfoPath.XmlForm NewFromFormTemplate(string formTemplateLocation, System.Xml.XPath.XPathNavigator xmlData);
abstract member NewFromFormTemplate : string * System.Xml.XPath.XPathNavigator -> Microsoft.Office.InfoPath.XmlForm
Public MustOverride Function NewFromFormTemplate (formTemplateLocation As String, xmlData As XPathNavigator) As XmlForm
Parámetros
- formTemplateLocation
- String
Identificador uniforme de recursos (URI) de la plantilla de formulario en que se va a basar el nuevo formulario.
- xmlData
- XPathNavigator
Objeto XPathNavigator que devuelve los datos XML que se van a usar como plantilla para el formulario.
Devoluciones
Objeto XmlForm que representa el nuevo formulario que se creó.
Excepciones
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.
El parámetro que se pasó a este método es una referencia nula (Nothing en Visual Basic).
El archivo especificado para formTemplateLocation no existe.
Se llamó a este método desde un controlador de eventos para el Loading evento.
Ejemplos
En el ejemplo de código siguiente, el método NewFromFormTemplate(formTemplateLocation, xmlData) de la XmlFormCollection clase se pasa el URI de una plantilla de formulario existente y un objeto XPathNavigator que devuelve datos XML y se devuelve el objeto XmlForm asociado del 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)
Comentarios
El método NewFromFormTemplate solo se puede usar para crear un nuevo formulario basado en una plantilla de formulario existente; no se puede usar para crear un formulario nuevo basado en un formulario. Para crear un formulario a partir de un formulario existente, use el New(String, XmlFormOpenMode) método .
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.
Se aplica a
NewFromFormTemplate(String, String, XmlFormOpenMode)
Crea un nuevo formulario mediante la plantilla de formulario especificada con los datos especificados por un XPathNavigator objeto y abierta en el especificado XmlFormOpenMode.
public:
abstract Microsoft::Office::InfoPath::XmlForm ^ NewFromFormTemplate(System::String ^ formTemplateLocation, System::String ^ xmlData, Microsoft::Office::InfoPath::XmlFormOpenMode behavior);
public abstract Microsoft.Office.InfoPath.XmlForm NewFromFormTemplate(string formTemplateLocation, string xmlData, Microsoft.Office.InfoPath.XmlFormOpenMode behavior);
abstract member NewFromFormTemplate : string * string * Microsoft.Office.InfoPath.XmlFormOpenMode -> Microsoft.Office.InfoPath.XmlForm
Public MustOverride Function NewFromFormTemplate (formTemplateLocation As String, xmlData As String, behavior As XmlFormOpenMode) As XmlForm
Parámetros
- formTemplateLocation
- String
Identificador uniforme de recursos (URI) de la plantilla de formulario en que se va a basar el nuevo formulario.
- xmlData
- String
Identificador uniforme de recursos (URI) del documento XML que proporciona los datos XML que se van a usar como plantilla para el formulario.
- behavior
- XmlFormOpenMode
Enumeración XmlFormOpenMode que especifica cómo se abrirá el formulario.
Devoluciones
Objeto XmlForm que representa el nuevo formulario que se creó.
Excepciones
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.
El parámetro que se pasó a este método es una referencia nula (Nothing en Visual Basic).
El archivo especificado para formTemplateLocation no existe.
Se llamó a este método desde un controlador de eventos para el Loading evento.
Ejemplos
En el siguiente ejemplo de código, el método NewFromFormTemplate(formTemplateLocation, xmlData,behavior) de la XmlFormCollection clase se pasa el URI de una plantilla de formulario existente, el URI de los datos XML, una enumeración XmlFormOpenMode y se devuelve el objeto XmlForm asociado del 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)
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 New(String, XmlFormOpenMode) método .
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.