SharepointListQueryConnection 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.

Achtung

The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.

Stellt eine Datenverbindung zum Abrufen von Daten aus einer SharePoint-Liste oder -Dokumentbibliothek dar.

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

[System.Obsolete("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : Microsoft.Office.InfoPath.DataConnection

type SharepointListQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharepointListQueryConnection
Inherits DataConnection

Vererbung: Object

DataConnection
SharepointListQueryConnection

Attribute: ObsoleteAttribute

Beispiele

Im folgenden Beispiel wird ein Verweis auf das SharePointListQueryConnection-Objekt , das die Verbindung mit dem Namen "Contacts" darstellt, die eine Verbindung mit einer Liste von Kontaktinformationen in SharePoint herstellt, festgelegt, indem der Name an die Item[String] Eigenschaft der DataConnectionCollection-Klasse übergeben und dann das zurückgegebene Objekt in den SharePointListQueryConnection-Typ umgewandelt wird.

[C#]

SharePointListQueryConnection spConnection = (SharePointListQueryConnection)this.DataConnections["Contacts"];

Dim spConnection As SharePointListQueryConnection = _
   DirectCast(Me.DataConnections("Contacts"), _
   SharePointListQueryConnection)

Nach dem Festlegen des Verweises können Sie die Eigenschaften oder Methoden des SharePointListQueryConnection-Objekts verwenden. Im folgenden Beispiel wird eine Zeichenfolgenvariable auf den Wert festgelegt, der von der von der NameDataConnection-Basisklasse geerbten Eigenschaft zurückgegeben wird.

string spName = spConnection.Name; Dim spName As String = spConnection.Name

Hinweise

Wichtig: Die SharepointListQueryConnection Klasse und ihre Member sind in Microsoft InfoPath veraltet. Code, der mit den Membern dieser Klasse geschrieben wurde, ist nur mit einer Datenverbindung mit einer SharePoint-Dokumentbibliothek kompatibel, die in InfoPath 2003 oder InfoPath 2007 erstellt wurde, mit einer Datenverbindung in einer neuen Formularvorlage, die in InfoPath mit einer der InfoPath 2007-Formularvorlagen erstellt wurde, oder mit einer Datenverbindung, die mit der Schaltfläche In vorherige Version konvertieren im Dialogfeld Daten Connections konvertiert wurde. Um Code zu schreiben, der mit einer Datenverbindung mit einer SharePoint-Dokumentbibliothek funktioniert, die in einer InfoPath-Formularvorlage erstellt wurde, verwenden Sie die Member der SharePointListRWQueryConnection -Klasse. Wenn Sie außerdem eine Datenverbindung mit einer SharePoint-Dokumentbibliothek mit der Schaltfläche In aktuelle Version konvertieren im Dialogfeld Daten Connections konvertieren, müssen Sie code neu schreiben, der mit den Membern der SharepointListQueryConnection -Klasse geschrieben wurde, um stattdessen die Member der SharePointListRWQueryConnection -Klasse zu verwenden.

Das SharePointListQueryConnection-Objekt stellt eine sekundäre Datenverbindung dar, die in InfoPath mithilfe des Datenverbindungs-Assistenten erstellt wurde und alle Informationen angibt, die zum Abrufen von Daten aus einer SharePoint-Liste oder -Dokumentbibliothek erforderlich sind.

Die SharePointListQueryConnection-Klasse stellt Eigenschaften bereit, die verwendet werden können, um den Namen der Datenverbindung und den URL (Uniform Resource Locator) der Liste oder Dokumentbibliothek auf der Windows SharePoint Services-Website abzurufen, von der die Verbindung Daten abruft.

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

Die Standardmethode Execute() , die von der DataConnection Basisklasse geerbt wird, führt einen Abfrage- oder Übermittlungsvorgang mit den Werten aus, die im InfoPath-Formularvorlagenentwurfsmodus deklarativ definiert wurden. Darüber hinaus stellt die SharePointListQueryConnection-Klasse die -Methode bereit, mit der Execute(XPathNavigator) Sie einen anderen Speicherort zum Einfügen der zurückgegebenen Daten angeben können.

Die SharePointListQueryConnection-Klasse entspricht der SharePointListAdapterObject-Schnittstelle des Microsoft Office InfoPath 2003-Objektmodells.

Konstruktoren

SharepointListQueryConnection()

Veraltet.

Stellt eine Datenverbindung zum Abrufen von Daten aus einer SharePoint-Liste oder -Dokumentbibliothek dar.

Eigenschaften

Name	Veraltet. Ruft den Namen der Datenverbindung ab. (Geerbt von DataConnection)
QueryThisFormOnly	Veraltet. Ruft ab, ob der Abfragevorgang nur auf das aktuelle Formular angewendet wird.
SiteUrl	Veraltet. Ruft ein System.Uri-Objekt ab, das die URL (Uniform Resource Locator) der Windows SharePoint Services Website darstellt, die dem SharepointListQueryConnection -Objekt zugeordnet ist.

Methoden

Execute()	Veraltet. 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)	Veraltet. Ü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