Freigeben über


SharepointListQueryConnection-Klasse

HINWEIS: Diese API ist jetzt veraltet.

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

Vererbungshierarchie

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

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
<ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")> _
Public MustInherit Class SharepointListQueryConnection _
    Inherits DataConnection
'Usage
Dim instance As SharepointListQueryConnection
[ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : DataConnection

Hinweise

Wichtig

Die SharepointListQueryConnection-Klasse und ihre Member sind in Microsoft InfoPath 2010 veraltet. Code, der mit Membern dieser Klasse geschrieben wurde, ist nur mit folgenden Datenverbindungen kompatibel: einer Datenverbindung zu einer SharePoint-Dokumentbibliothek, die in InfoPath 2003 oder InfoPath 2007 erstellt wurde, einer Datenverbindung in einer neuen Formularvorlage, die in InfoPath 2010 mit einer der InfoPath 2007-Formularvorlagen erstellt wurde, oder einer Datenverbindung, die mithilfe der Schaltfläche In frühere Version konvertieren im Dialogfeld Datenverbindungen konvertiert wurde. Zum Schreiben von Code, der mit einer Datenverbindung zu einer SharePoint-Dokumentbibliothek funktioniert, die in einer InfoPath 2010-Formularvorlage erstellt wurde, verwenden Sie die Member der SharePointListRWQueryConnection-Klasse. Darüber hinaus gilt Folgendes: Wenn Sie eine Datenverbindung zu einer SharePoint-Dokumentbibliothek mit der Schaltfläche In aktuelle Version konvertieren im Dialogfeld Datenverbindungen konvertieren, müssen Sie den gesamten Code, der unter Verwendung der Member der SharepointListQueryConnection-Klasse geschrieben wurde, so umschreiben, dass stattdessen die Member der SharePointListRWQueryConnection-Klasse verwendet werden.

Das SharePointListQueryConnection-Objekt stellt eine in InfoPath mithilfe desDatenverbindungs-Assistenten erstellte sekundäre 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.

Beispiele

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

Threadsicherheit

Alle öffentlichen static (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