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.