SharePointListRWQueryConnection-Klasse
Stellt eine Verbindung zum Abrufen von Daten aus einer SharePoint-Liste oder -Dokumentbibliothek dar.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SharePointListRWQueryConnection
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class SharePointListRWQueryConnection _
Inherits DataConnection
'Usage
Dim instance As SharePointListRWQueryConnection
public abstract class SharePointListRWQueryConnection : DataConnection
Hinweise
Die SharePointListRWQueryConnection-Klasse stellt eine in InfoPath erstellte sekundäre Datenverbindung dar, die alle Informationen angibt, die zum Abrufen von Daten aus einer SharePoint-Liste oder Dokumentbibliothek benötigt werden. Zum Erstellen einer Formularvorlage, die eine sekundäre Datenverbindung zu einer SharePoint-Liste oder -Dokumentbibliothek enthält, verwenden Sie den Befehl Datenverbindungen auf der Registerkarte Daten.
Hinweis
Code, der mit Membern der SharePointListRWQueryConnection-Klasse geschrieben wurde, ist nicht kompatibel mit einer in InfoPath 2003 oder InfoPath 2007 erstellten Datenverbindung zu einer SharePoint-Liste oder -Dokumentbibliothek, mit einer Datenverbindung in einer neuen Formularvorlage, die in InfoPath mit einer der InfoPath 2007-Formularvorlagen erstellt wurde, oder mit einer Datenverbindung, die mithilfe der Schaltfläche In frühere Version konvertieren im Dialogfeld Datenverbindungen konvertiert wurde. Wenn die Kompatibilität mit einer früheren Version von InfoPath nicht erhalten bleiben muss und Sie Code mit Membern der SharePointListRWQueryConnection-Klasse schreiben möchten, konvertieren Sie die Datenverbindung mithilfe der Schaltfläche In aktuelle Version konvertieren im Dialogfeld Datenverbindungen.
Hinweis
Sie können eine primäre Datenverbindung (Hauptdatenverbindung) zu einer SharePoint-Liste erstellen, indem Sie mit der Vorlage SharePoint-Liste eine neue Formularvorlage erstellen. Allerdings ist es nicht möglich, Formularcode hinter einem solchen Formular zu schreiben, weil in einer mit der Vorlage SharePoint-Liste erstellten Formularvorlage nur deklarative Logik unterstützt wird, z. B. Regeln. Aus diesem Grund können Sie die SharePointListRWQueryConnection-Klasse und ihre Member nicht zum Arbeiten mit einer primären Datenverbindung zu einer SharePoint-Liste verwenden.
Die SharePointListRWQueryConnection-Klasse stellt Eigenschaften bereit, die zum Abrufen des Namens der Datenverbindung und der URL der Liste oder Dokumentbibliothek auf der SharePoint Foundation- oder Microsoft SharePoint Server-Website, von der die Verbindung Daten abruft, verwendet werden können.
Auf das der Datenverbindung zugeordnete SharePointListRWQueryConnection-Objekt kann zugegriffen werden, indem Sie die DataConnections-Eigenschaft der XmlForm-Klasse verwenden, damit die Verbindung aus der DataConnectionCollection-Auflistung der Formularvorlage zurückgegeben wird.
Die standardmäßige Execute-Methode, die aus der DataConnection-Basisklasse geerbt wird, führt unter Verwendung der Werte, die zur Entwurfszeit in der InfoPath-Formularvorlage deklarativ definiert wurden, einen Abfrage- oder Sendevorgang aus. Zusätzlich stellt die SharePointListRWQueryConnection-Klasse die Execute(XPathNavigator)-Methode bereit, die das Angeben eines anderen Speicherorts zum Einfügen der zurückgegebenen Daten ermöglicht.
Beispiele
Im folgenden Codebeispiel wird in zwei Schritten auf eine Datenverbindung mit dem Namen "Contacts" zugegriffen, die eine Verbindung zu einer Liste mit Kontaktinformationen auf einer SharePoint-Website herstellt. Der Name "Contacts" wird an die Item-Eigenschaft der DataConnectionCollection-Klasse übergeben, um ein Objekt abzurufen, das die Datenverbindung darstellt. Anschließend wird das von der Auflistung zurückgegebene Objekt in den SharePointListRWQueryConnection-Typ umgewandelt.
SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListRWQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListRWQueryConnection)
Nachdem Sie den Verweis auf die Datenverbindung festgelegt haben, können Sie die Eigenschaften oder Methoden des SharePointListRWQueryConnection-Objekts verwenden. Im folgenden Codebeispiel wird eine Zeichenfolgenvariable auf den Wert festgelegt, den die Name-Eigenschaft zurückgibt, die aus der DataConnection-Basisklasse geerbt wird.
string spName = spConnection.Name;
Dim spName As String = spConnection.Name
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.