SharepointListQueryConnection-Klasse

Artikel
04/27/2010

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

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustInherit Class SharepointListQueryConnection
    Inherits DataConnection
'Usage
Dim instance As SharepointListQueryConnection

public abstract class SharepointListQueryConnection : DataConnection

Hinweise

Das SharePointListQueryConnection-Objekt stellt eine in InfoPath mithilfe desDatenverbindungs-Assistenten erstellte Datenverbindung dar, die alle zum Abrufen von Daten aus einer SharePoint-Liste oder -Dokumentbibliothek erforderlichen Informationen angibt.

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 aus der DataConnectionCollection-Auflistung der Formularvorlage zurückzugeben.

Die standardmäßige Execute-Methode, die von der DataConnection-Basisklasse geerbt wird, führt einen Abfrage- oder Sendevorgang mithilfe der Werte aus, die im InfoPath-Entwurfsmodus für Formularvorlagen deklarativ definiert wurden. Zusätzlich stellt die SharePointListQueryConnection-Klasse die SharepointListQueryConnection.Execute-Methode bereit, die das Angeben eines anderen Speicherorts zum Einfügen der zurückgegebenen Daten ermöglicht.

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

Beispiel

Im folgenden Beispiel wird ein Verweis auf das SharePointListQueryConnection-Objekt festgelegt, das die Verbindung namens "Contacts" zum Verbinden mit einer Liste von Kontaktinformationen in SharePoint darstellt, indem der Name an die Item-Eigenschaft der DataConnectionCollection-Klasse übergeben und das zurückgegebene Objekt dann 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 durch die von der DataConnection-Basisklasse geerbte Name-Eigenschaft zurückgegeben wird.

string spName = spConnection.Name;

Dim spName As String = spConnection.Name

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SharepointListQueryConnection

Threadsicherheit

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

Siehe auch

Referenz

SharepointListQueryConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über