XmlFormCollection.NewFromFormTemplate Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Sobrecargas

NewFromFormTemplate(String)	Cria um novo formulário baseado no modelo de formulário especificado, com dados opcionais.
NewFromFormTemplate(String, String)	Cria um novo formulário que utiliza o modelo de formulário especificado e o ficheiro de dados XML.
NewFromFormTemplate(String, XPathNavigator)	Cria um novo formulário com o modelo de formulário especificado com dados especificados por um XPathNavigator objeto.
NewFromFormTemplate(String, String, XmlFormOpenMode)	Cria um novo formulário com o modelo de formulário especificado com dados especificados por um XPathNavigator objeto e abertos no especificado XmlFormOpenMode.

NewFromFormTemplate(String)

Cria um novo formulário baseado no modelo de formulário especificado, com dados opcionais.

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

O Uniform Resource Identifier (URI) do modelo de formulário no qual se baseia o novo formulário.

Retornos

XmlForm

Um XmlForm objeto que representa o novo formulário que foi criado.

Exceções

ArgumentException

O parâmetro que foi transmitido para este método não é válido. Por exemplo, é do tipo ou formato errado.

ArgumentNullException

O parâmetro que foi transmitido para este método é uma referência nula (Nada no Visual Basic).

FileNotFoundException

O ficheiro especificado para formTemplateLocation não existe.

InvalidOperationException

Este método foi chamado a partir de um processador de eventos para o Loading evento.

Exemplos

No exemplo de código seguinte, o método NewFromFormTemplate(formTemplateLocation) da XmlFormCollection classe é transmitido ao URI de um modelo de formulário existente e é devolvido o objeto XmlForm associado ao novo formulário.

XmlForm newDocument = 
   this.Application.XmlForms.NewFromFormTemplate(
   @"C:\MyForm.xsn");

Dim newDocument As XmlForm  = _
   Me.Application.XmlForms.NewFromFormTemplate(_
   "C:\MyForm.xsn")

Comentários

O método NewFromFormTemplate só pode ser utilizado para criar um novo formulário baseado num modelo de formulário existente; não pode ser utilizado para criar um novo formulário baseado num formulário. Para criar um formulário a partir de um formulário existente, utilize o New(String, XmlFormOpenMode) método .

Quando utiliza o método NewFromFormTemplate , o novo formulário é aberto no InfoPath e está pronto para ser preenchido.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

NewFromFormTemplate(String, String)

Cria um novo formulário que utiliza o modelo de formulário especificado e o ficheiro de dados XML.

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

O Uniform Resource Identifier (URI) do modelo de formulário no qual se baseia o novo formulário.

xmlData

String

O Uniform Resource Identifier (URI) do documento XML que fornece os dados XML a serem utilizados como um modelo para o formulário.

Retornos

XmlForm

Um XmlForm objeto que representa o novo formulário que foi criado.

Exceções

ArgumentException

O parâmetro que foi transmitido para este método não é válido. Por exemplo, é do tipo ou formato errado.

ArgumentNullException

O parâmetro que foi transmitido para este método é uma referência nula (Nada no Visual Basic).

FileNotFoundException

O ficheiro especificado para formTemplateLocation não existe.

InvalidOperationException

Este método foi chamado a partir de um processador de eventos para o Loading evento.

Exemplos

No exemplo de código seguinte, o método NewFromFormTemplate(formTemplateLocation, xmlData) da XmlFormCollection classe é transmitido o URI de um modelo de formulário existente, o URI dos dados XML e o objeto XmlForm associado ao novo formulário é devolvido.

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")

Comentários

O método NewFromFormTemplate só pode ser utilizado para criar um novo formulário baseado num modelo de formulário existente; não pode ser utilizado para criar um novo formulário baseado num formulário. Para criar um formulário a partir de um formulário existente, utilize o New(String, XmlFormOpenMode) método .

Quando utiliza o método NewFromFormTemplate , o novo formulário é aberto no InfoPath e está pronto para ser preenchido.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

NewFromFormTemplate(String, XPathNavigator)

Cria um novo formulário com o modelo de formulário especificado com dados especificados por um 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

O Uniform Resource Identifier (URI) do modelo de formulário no qual se baseia o novo formulário.

xmlData

XPathNavigator

Um XPathNavigator objeto que devolve os dados XML a serem utilizados como um modelo para o formulário.

Retornos

XmlForm

Um XmlForm objeto que representa o novo formulário que foi criado.

Exceções

ArgumentException

O parâmetro que foi transmitido para este método não é válido. Por exemplo, é do tipo ou formato errado.

ArgumentNullException

O parâmetro que foi transmitido para este método é uma referência nula (Nada no Visual Basic).

FileNotFoundException

O ficheiro especificado para formTemplateLocation não existe.

InvalidOperationException

Este método foi chamado a partir de um processador de eventos para o Loading evento.

Exemplos

No exemplo de código seguinte, o método NewFromFormTemplate(formTemplateLocation, xmlData) da XmlFormCollection classe é transmitido o URI de um modelo de formulário existente e um objeto XPathNavigator que devolve dados XML e o objeto XmlForm associado ao novo formulário é devolvido.

// 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)

Comentários

O método NewFromFormTemplate só pode ser utilizado para criar um novo formulário baseado num modelo de formulário existente; não pode ser utilizado para criar um novo formulário baseado num formulário. Para criar um formulário a partir de um formulário existente, utilize o New(String, XmlFormOpenMode) método .

Quando utiliza o método NewFromFormTemplate , o novo formulário é aberto no InfoPath e está pronto para ser preenchido.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

NewFromFormTemplate(String, String, XmlFormOpenMode)

Cria um novo formulário com o modelo de formulário especificado com dados especificados por um XPathNavigator objeto e abertos no 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

O Uniform Resource Identifier (URI) do modelo de formulário no qual se baseia o novo formulário.

xmlData

String

O Uniform Resource Identifier (URI) do documento XML que fornece os dados XML a serem utilizados como um modelo para o formulário.

behavior

XmlFormOpenMode

Uma XmlFormOpenMode enumeração que especifica como o formulário será aberto.

Retornos

XmlForm

Um XmlForm objeto que representa o novo formulário que foi criado.

Exceções

ArgumentException

O parâmetro que foi transmitido para este método não é válido. Por exemplo, é do tipo ou formato errado.

ArgumentNullException

O parâmetro que foi transmitido para este método é uma referência nula (Nada no Visual Basic).

FileNotFoundException

O ficheiro especificado para formTemplateLocation não existe.

InvalidOperationException

Este método foi chamado a partir de um processador de eventos para o Loading evento.

Exemplos

No exemplo de código seguinte, o método NewFromFormTemplate(formTemplateLocation, xmlData,behavior) da XmlFormCollection classe é transmitido o URI de um modelo de formulário existente, o URI dos dados XML, uma enumeração XmlFormOpenMode e o objeto XmlForm associado ao novo formulário é devolvido.

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)

Comentários

O método NewFromFormTemplate só pode ser utilizado para criar um novo formulário baseado num modelo de formulário existente; não pode ser utilizado para criar um novo formulário baseado num formulário. Para criar um formulário a partir de um formulário existente, utilize o New(String, XmlFormOpenMode) método .

Quando utiliza o método NewFromFormTemplate , o novo formulário é aberto no InfoPath e está pronto para ser preenchido.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.