Partager via

SharePointListRWQueryConnection Classe

  • Référence

Définition

Espace de noms:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Représente une connexion pour l’extraction de données d’une bibliothèque de documents ou d’une liste SharePoint.

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
Héritage
Object
DataConnection
SharePointListRWQueryConnection

Exemples

Dans l’exemple de code suivant, l’accès à une connexion de données nommée « Contacts », qui se connecte à une liste d’informations de contact sur un site SharePoint, s’effectue selon le processus en deux étapes suivant. Le nom « Contacts » est passé à la Item[String] propriété de la DataConnectionCollection classe pour récupérer un objet qui représente la connexion de données. Ensuite, l’objet retourné à partir de la collection est converti en SharePointListRWQueryConnection type .

SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"]; 
Dim spConnection As SharePointListRWQueryConnection = _
   DirectCast(Me.DataConnections("Contacts"), _
   SharePointListRWQueryConnection)

Une fois que la référence à la connexion de données a été définie, vous pouvez utiliser les propriétés ou méthodes de l’objet SharePointListRWQueryConnection . L’exemple de code suivant définit une variable de chaîne sur la valeur retournée par la Name propriété héritée de la DataConnection classe de base.

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

Remarques

La SharePointListRWQueryConnection classe représente une connexion de données secondaire créée dans InfoPath qui spécifie toutes les informations nécessaires pour récupérer des données à partir d’une liste ou d’une bibliothèque de documents SharePoint. Pour créer un modèle de formulaire qui contient une connexion de données secondaire vers une bibliothèque de documents ou une liste SharePoint, utilisez la commande Connexions de données de l’onglet Données.

Remarque : Le code écrit avec les membres de la SharePointListRWQueryConnection classe n’est pas compatible avec une connexion de données à une liste ou bibliothèque de documents SharePoint créée dans InfoPath 2003 ou InfoPath 2007, avec une connexion de données dans un nouveau modèle de formulaire créé dans InfoPath avec l’un des modèles de formulaires InfoPath 2007, ou avec une connexion de données convertie avec le bouton Convertir en version précédente dans la boîte de dialogue Connections de données. Si vous n’avez pas besoin de maintenir la compatibilité avec une version antérieure d’InfoPath et que vous souhaitez écrire du code avec des membres de la SharePointListRWQueryConnection classe, convertissez la connexion de données avec le bouton Convertir en version actuelle dans la boîte de dialogue Connections de données.

Remarque : vous pouvez créer une connexion de données principale (main) à une liste SharePoint en créant un modèle de formulaire avec le modèle Liste SharePoint. Cependant, il est impossible d’écrire du code pour ce type de formulaire, car un modèle de formulaire créé à partir du modèle Liste SharePoint prend en charge uniquement la logique déclarative, comme les règles. Pour cette raison, vous ne pouvez pas utiliser la SharePointListRWQueryConnection classe et ses membres pour utiliser une connexion de données principale à une liste SharePoint.

La SharePointListRWQueryConnection classe fournit des propriétés qui peuvent être utilisées pour obtenir le nom de la connexion de données et l’URL de la liste ou de la bibliothèque de documents sur le site SharePoint Foundation ou Microsoft SharePoint Server à partir duquel la connexion récupère des données.

L’objet SharePointListRWQueryConnection associé à la connexion de données est accessible à l’aide de la DataConnections propriété de la XmlForm classe pour retourner la connexion à partir du DataConnectionCollection du modèle de formulaire.

La méthode par défaut Execute() , héritée de la DataConnection classe de base, effectue une opération de requête ou d’envoi à l’aide des valeurs définies de manière déclarative dans le modèle de formulaire InfoPath au moment du design. En outre, la SharePointListRWQueryConnection classe fournit la Execute(XPathNavigator) méthode , qui vous permet de spécifier un autre emplacement pour insérer les données retournées.

Constructeurs

SharePointListRWQueryConnection()

Représente une connexion pour l’extraction de données d’une bibliothèque de documents ou d’une liste SharePoint.

Propriétés

ContentTypeId

Obtient ou définit l’ID de type de contenu de la liste SharePoint associée à l’objet SharePointListRWQueryConnection .
ListId

Obtient ou définit l’ID de liste de la liste SharePoint associée à l’objet SharePointListRWQueryConnection .
Name

Obtient le nom de la connexion de données.

(Hérité de DataConnection)
SiteUrl

Obtient ou définit un Uri objet qui représente l’URL du site SharePoint Foundation associé à l’objet Microsoft.Office.InfoPath.SharepointListRWQueryConnection .

Méthodes

Execute()

Selon la classe TypeConnexionConnection à partir de laquelle elle est appelée, exécute une opération de requête ou d'envoi sur la connexion de données en utilisant les valeurs définies de façon déclarative pour les données envoyées, les paramètres de la requête ou les données à récupérer.

(Hérité de DataConnection)
Execute(XPathNavigator)

Remplace la méthode par défaut Execute() pour activer la spécification d’un autre emplacement pour insérer les données retournées.

S’applique à