FileQueryConnection Klasse

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

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.

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

public ref class FileQueryConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class FileQueryConnection : Microsoft.Office.InfoPath.DataConnection

type FileQueryConnection = class
    inherit DataConnection

Public MustInherit Class FileQueryConnection
Inherits DataConnection

Vererbung: Object

DataConnection
FileQueryConnection

Hinweise

Die FileQueryConnection-Klasse stellt eine Datenverbindung dar, die in InfoPath mithilfe des Datenverbindungs-Assistenten erstellt wurde und alle Informationen angibt, die zum Abrufen von Daten aus einer XML-Datei erforderlich sind, die als sekundäre (externe) Datenquelle verwendet wird.

Auf das FileQueryConnection-Objekt kann mithilfe der DataConnections -Eigenschaft der XmlForm -Klasse zugegriffen werden, um die Verbindung von der DataConnectionCollection der Formularvorlage zurückzugeben.

Auf das FileQueryConnection-Objekt kann auch von der Formularvorlage aus DataSourceCollection zugegriffen werden, indem die DataSources -Eigenschaft von XmlFormund die QueryConnection -Eigenschaft der DataSource -Klasse verwendet wird, 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, die zum Abrufen oder Festlegen des URL-Pfads (Uniform Resource Locator) oder des UNC-Pfads (Universal Naming Convention) der XML-Datei verwendet werden kann, die als externe Datenquelle verwendet wird.

Zusätzlich zur Standardmethode Execute() , die von der DataConnection Basisklasse geerbt wird, die einen Abfragevorgang mit den Werten ausführt, die im InfoPath-Formularvorlagenentwurfsmodus deklarativ definiert wurden, stellt die FileQueryConnection-Klasse auch die -Methode bereit, mit der Execute(XPathNavigator) Sie einen anderen XML-Knoten angeben können, in den die von der externen XML-Datei zurückgegebenen Daten eingefügt werden.

Die FileQueryConnection-Klasse entspricht der XMLFileAdapterObject-Klasse des Microsoft Office InfoPath 2003-Objektmodells.

Konstruktoren

FileQueryConnection()

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

Eigenschaften

FileLocation	Ruft den URL-Pfad (Uniform Resource Locator) oder UNC-Pfad (Universal Naming Convention) der XML-Datei ab, die dem -Objekt zugeordnet ist, oder legt diesen FileQueryConnection fest.
Name	Ruft den Namen der Datenverbindung ab. (Geerbt von DataConnection)

Methoden

Execute()	Je nachdem, von welcher ConnectionType die Connection-Klasse aufgerufen wird, wird ein Sende- oder Abfragevorgang in der Datenverbindung ausgeführt. Dabei werden deklarativ definierte Werte für die gesendeten Daten, Abfrageparameter oder abzurufenden Daten verwendet. (Geerbt von DataConnection)
Execute(XPathNavigator)	Überschreibt die Standardmethode Execute() , um die Angabe eines anderen Speicherorts zum Einfügen der zurückgegebenen Daten zu ermöglichen.

Gilt für:

Freigeben über