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

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

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

public abstract class SharePointListRWQueryConnection : Microsoft.Office.InfoPath.DataConnection

type SharePointListRWQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharePointListRWQueryConnection
Inherits DataConnection

Vererbung: Object

DataConnection
SharePointListRWQueryConnection

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[String] -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 der Verweis auf die Datenverbindung festgelegt wurde, können Sie die Eigenschaften oder Methoden des SharePointListRWQueryConnection Objekts verwenden. Im folgenden Codebeispiel wird eine Zeichenfolgenvariable auf den Wert festgelegt, der von der von DataConnection der Name Basisklasse geerbten Eigenschaft zurückgegeben wird.

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

Hinweise

Die SharePointListRWQueryConnection -Klasse stellt eine sekundäre Datenverbindung dar, die in InfoPath erstellt wurde und alle Informationen angibt, die zum Abrufen von Daten aus einer SharePoint-Liste oder -Dokumentbibliothek erforderlich sind. 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 den Membern der SharePointListRWQueryConnection Klasse geschrieben wurde, ist nicht kompatibel mit einer Datenverbindung mit einer SharePoint-Liste oder -Dokumentbibliothek, 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. Wenn Sie die Kompatibilität mit einer früheren Version von InfoPath nicht aufrechterhalten müssen und Code mit Membern der SharePointListRWQueryConnection Klasse schreiben möchten, konvertieren Sie die Datenverbindung über die Schaltfläche In aktuelle Version konvertieren im Dialogfeld Daten Connections.

Hinweis: Sie können eine primäre (Standard) Datenverbindung mit einer SharePoint-Liste erstellen, indem Sie eine neue Formularvorlage mit der SharePoint-Listenvorlage 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 verwenden, um mit einer primären Datenverbindung mit einer SharePoint-Liste zu arbeiten.

Die SharePointListRWQueryConnection -Klasse stellt Eigenschaften bereit, die verwendet werden können, um den Namen der Datenverbindung und die URL der Liste oder Dokumentbibliothek auf der SharePoint Foundation- oder Microsoft SharePoint Server-Website abzurufen, von der die Verbindung Daten abruft.

Auf SharePointListRWQueryConnection das der Datenverbindung zugeordnete Objekt kann mithilfe der DataConnections -Eigenschaft der XmlForm -Klasse zugegriffen werden, um die Verbindung aus dem DataConnectionCollection der Formularvorlage zurückzugeben.

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

Konstruktoren

SharePointListRWQueryConnection()

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

Eigenschaften

ContentTypeId	Ruft die Inhaltstyp-ID der SharePoint-Liste ab, die dem -Objekt zugeordnet ist, oder legt diese SharePointListRWQueryConnection fest.
ListId	Ruft die Listen-ID der SharePoint-Liste ab, die dem -Objekt zugeordnet ist, oder legt diese SharePointListRWQueryConnection fest.
Name	Ruft den Namen der Datenverbindung ab. (Geerbt von DataConnection)
SiteUrl	Ruft ein Uri -Objekt ab, das die URL der SharePoint Foundation-Website darstellt, die dem -Objekt zugeordnet ist, oder legt dieses Microsoft.Office.InfoPath.SharepointListRWQueryConnection fest.

Methoden

Execute()	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)	Überschreibt die Standardmethode Execute() , um die Angabe eines anderen Speicherorts zum Einfügen der zurückgegebenen Daten zu aktivieren.

Gilt für:

Freigeben über