FileQueryConnection-Klasse

Artikel
04/27/2010

Stellt eine Verbindung zum Abrufen von Daten aus einer XML-Datei dar.

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.

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.FileQueryConnection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

FileQueryConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über