FileQueryConnection-Klasse
Stellt eine Verbindung zum Abrufen von Daten aus einer XML-Datei dar.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.FileQueryConnection
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class FileQueryConnection _
Inherits DataConnection
'Usage
Dim instance As FileQueryConnection
public abstract class FileQueryConnection : DataConnection
Hinweise
Die FileQueryConnection-Klasse stellt eine Datenverbindung dar, die in InfoPath mithilfe desDatenverbindungs-Assistenten erstellt wurde und alle erforderlichen Informationen zum Abrufen von Daten aus einer XML-Datei angibt, die als sekundäre (externe) Datenquelle verwendet wird.
Der Zugriff auf das FileQueryConnection-Objekt erfolgt mithilfe der DataConnections-Eigenschaft der XmlForm-Klasse, um die Verbindung aus der DataConnectionCollection-Auflistung der Formularvorlage zurückzugeben.
Der Zugriff auf das FileQueryConnection-Objekt erfolgt ebenfalls von der DataSourceCollection-Auflistung der Formularvorlage mithilfe der DataSources-Eigenschaft der XmlForm-Klasse und der QueryConnection-Eigenschaft der DataSource-Klasse, wie in der folgenden Codezeile gezeigt.
FileQueryConnection myDataSource =
(FileQueryConnection)(DataSources["XMLFile"].QueryConnection);
Dim myDataSource As FileQueryConnection =
DirectCast(DataSources("XMLFile").QueryConnection, _
FileQueryConnection)
Die FileQueryConnection-Klasse stellt die FileLocation-Eigenschaft bereit. Diese kann verwendet werden, um den URL (Uniform Resource Locator) oder UNC-Pfad (Universal Naming Convention) der XML-Datei, die als externe Datenquelle verwendet wird, abzurufen oder festzulegen.
Zusätzlich zur standardmäßigen Execute-Methode, die von der DataConnection-Basisklasse geerbt wird und einen Abfragevorgang mithilfe der Werte ausführt, die im InfoPath-Entwurfsmodus für Formularvorlagen deklarativ definiert wurden, stellt die FileQueryConnection-Klasse auch die FileQueryConnection.Execute-Methode bereit, mit der Sie einen anderen XML-Knoten angeben können, in den die von der externen XML-Datei zurückgegebenen Daten eingefügt werden sollen.
Die FileQueryConnection-Klasse entspricht der XMLFileAdapterObject-Klasse des Microsoft Office InfoPath 2003-Objektmodells.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.