XmlFormCollection.NewFromFormTemplate Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| NewFromFormTemplate(String) |
Erstellt ein neues Formular, das auf der angegebenen Formularvorlage basiert, mit optionalen Daten. |
| NewFromFormTemplate(String, String) |
Erstellt ein neues Formular, das die angegebene Formularvorlage und XML-Datendatei verwendet. |
| NewFromFormTemplate(String, XPathNavigator) |
Erstellt ein neues Formular mithilfe der angegebenen Formularvorlage mit daten, die von einem XPathNavigator -Objekt angegeben werden. |
| NewFromFormTemplate(String, String, XmlFormOpenMode) |
Erstellt ein neues Formular mithilfe der angegebenen Formularvorlage mit Daten, die von einem XPathNavigator -Objekt angegeben und im angegebenen XmlFormOpenModegeöffnet werden. |
NewFromFormTemplate(String)
Erstellt ein neues Formular, das auf der angegebenen Formularvorlage basiert, mit optionalen Daten.
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.XmlFormPublic MustOverride Function NewFromFormTemplate (formTemplateLocation As String) As XmlFormParameter
- formTemplateLocation
- String
Der URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.
Gibt zurück
Ein XmlForm -Objekt, das das neue Formular darstellt, das erstellt wurde.
Ausnahmen
Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.
Der Parameter, der an diese Methode übergeben wurde, ist ein NULL-Verweis (Nothing in Visual Basic).
Die für formTemplateLocation angegebene Datei ist nicht vorhanden.
Diese Methode wurde von einem Ereignishandler für das Loading -Ereignis aufgerufen.
Beispiele
Im folgenden Codebeispiel wird der NewFromFormTemplate(formTemplateLocation) -Methode der XmlFormCollection Klasse der URI einer vorhandenen Formularvorlage übergeben, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn")
Hinweise
Die NewFromFormTemplate-Methode kann nur verwendet werden, um ein neues Formular zu erstellen, das auf einer vorhandenen Formularvorlage basiert. Es kann nicht verwendet werden, um ein neues Formular zu erstellen, das auf einem Formular basiert. Verwenden Sie die New(String, XmlFormOpenMode) -Methode, um ein Formular aus einem vorhandenen Formular zu erstellen.
Wenn Sie die NewFromFormTemplate-Methode verwenden, wird das neue Formular in InfoPath geöffnet und kann sofort ausgefüllt werden.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.
Gilt für:
NewFromFormTemplate(String, String)
Erstellt ein neues Formular, das die angegebene Formularvorlage und XML-Datendatei verwendet.
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.XmlFormPublic MustOverride Function NewFromFormTemplate (formTemplateLocation As String, xmlData As String) As XmlFormParameter
- formTemplateLocation
- String
Der URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.
- xmlData
- String
Der URI (Uniform Resource Identifier) des XML-Dokuments, das die als Vorlage für das Formular zu verwendenden XML-Daten bereitstellt.
Gibt zurück
Ein XmlForm -Objekt, das das neue Formular darstellt, das erstellt wurde.
Ausnahmen
Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.
Der Parameter, der an diese Methode übergeben wurde, ist ein NULL-Verweis (Nothing in Visual Basic).
Die für formTemplateLocation angegebene Datei ist nicht vorhanden.
Diese Methode wurde von einem Ereignishandler für das Loading -Ereignis aufgerufen.
Beispiele
Im folgenden Codebeispiel wird der NewFromFormTemplate(formTemplateLocation, xmlData) -Methode der XmlFormCollection Klasse der URI einer vorhandenen Formularvorlage, der URI der XML-Daten übergeben, und das dem neuen Formular zugeordnete XmlForm-Objekt wird zurückgegeben.
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")
Hinweise
Die NewFromFormTemplate-Methode kann nur verwendet werden, um ein neues Formular zu erstellen, das auf einer vorhandenen Formularvorlage basiert. Es kann nicht verwendet werden, um ein neues Formular zu erstellen, das auf einem Formular basiert. Verwenden Sie die New(String, XmlFormOpenMode) -Methode, um ein Formular aus einem vorhandenen Formular zu erstellen.
Wenn Sie die NewFromFormTemplate-Methode verwenden, wird das neue Formular in InfoPath geöffnet und kann sofort ausgefüllt werden.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.
Gilt für:
NewFromFormTemplate(String, XPathNavigator)
Erstellt ein neues Formular mithilfe der angegebenen Formularvorlage mit daten, die von einem XPathNavigator -Objekt angegeben werden.
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.XmlFormPublic MustOverride Function NewFromFormTemplate (formTemplateLocation As String, xmlData As XPathNavigator) As XmlFormParameter
- formTemplateLocation
- String
Der URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.
- xmlData
- XPathNavigator
Ein XPathNavigator -Objekt, das die XML-Daten zurückgibt, die als Vorlage für das Formular verwendet werden sollen.
Gibt zurück
Ein XmlForm -Objekt, das das neue Formular darstellt, das erstellt wurde.
Ausnahmen
Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.
Der Parameter, der an diese Methode übergeben wurde, ist ein NULL-Verweis (Nothing in Visual Basic).
Die für formTemplateLocation angegebene Datei ist nicht vorhanden.
Diese Methode wurde von einem Ereignishandler für das Loading -Ereignis aufgerufen.
Beispiele
Im folgenden Codebeispiel wird der NewFromFormTemplate(formTemplateLocation, xmlData) -Methode der XmlFormCollection Klasse der URI einer vorhandenen Formularvorlage und eines XPathNavigator-Objekts übergeben, das XML-Daten zurückgibt, und das dem neuen Formular zugeordnete XmlForm-Objekt zurückgegeben.
// 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)
Hinweise
Die NewFromFormTemplate-Methode kann nur verwendet werden, um ein neues Formular zu erstellen, das auf einer vorhandenen Formularvorlage basiert. Es kann nicht verwendet werden, um ein neues Formular zu erstellen, das auf einem Formular basiert. Verwenden Sie die New(String, XmlFormOpenMode) -Methode, um ein Formular aus einem vorhandenen Formular zu erstellen.
Wenn Sie die NewFromFormTemplate-Methode verwenden, wird das neue Formular in InfoPath geöffnet und kann sofort ausgefüllt werden.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.
Gilt für:
NewFromFormTemplate(String, String, XmlFormOpenMode)
Erstellt ein neues Formular mithilfe der angegebenen Formularvorlage mit Daten, die von einem XPathNavigator -Objekt angegeben und im angegebenen XmlFormOpenModegeöffnet werden.
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.XmlFormPublic MustOverride Function NewFromFormTemplate (formTemplateLocation As String, xmlData As String, behavior As XmlFormOpenMode) As XmlFormParameter
- formTemplateLocation
- String
Der URI (Uniform Resource Identifier) der Formularvorlage, auf der das neue Formular basieren soll.
- xmlData
- String
Der URI (Uniform Resource Identifier) des XML-Dokuments, das die als Vorlage für das Formular zu verwendenden XML-Daten bereitstellt.
- behavior
- XmlFormOpenMode
Eine XmlFormOpenMode -Enumeration, die angibt, wie das Formular geöffnet wird.
Gibt zurück
Ein XmlForm -Objekt, das das neue Formular darstellt, das erstellt wurde.
Ausnahmen
Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.
Der Parameter, der an diese Methode übergeben wurde, ist ein NULL-Verweis (Nothing in Visual Basic).
Die für formTemplateLocation angegebene Datei ist nicht vorhanden.
Diese Methode wurde von einem Ereignishandler für das Loading -Ereignis aufgerufen.
Beispiele
Im folgenden Codebeispiel wird der NewFromFormTemplate(formTemplateLocation,, xmlDatabehavior)-Methode der XmlFormCollection Klasse der URI einer vorhandenen Formularvorlage, der URI der XML-Daten, eine XmlFormOpenMode-Enumeration und das dem neuen Formular zugeordnete XmlForm-Objekt zurückgegeben.
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)
Hinweise
Die NewFromFormTemplate-Methode kann nur verwendet werden, um ein neues Formular zu erstellen, das auf einer vorhandenen Formularvorlage basiert. Es kann nicht verwendet werden, um ein neues Formular zu erstellen, das auf einem Formular basiert. Verwenden Sie die New(String, XmlFormOpenMode) -Methode, um ein Formular aus einem vorhandenen Formular zu erstellen.
Wenn Sie die NewFromFormTemplate-Methode verwenden, wird das neue Formular in InfoPath geöffnet und kann sofort ausgefüllt werden.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.