SharePointListRWQueryConnection, classe
Représente une connexion pour l’extraction de données d’une bibliothèque de documents ou d’une liste SharePoint.
Hiérarchie d'héritage
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SharePointListRWQueryConnection
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustInherit Class SharePointListRWQueryConnection _
Inherits DataConnection
'Utilisation
Dim instance As SharePointListRWQueryConnection
public abstract class SharePointListRWQueryConnection : DataConnection
Remarques
La classe SharePointListRWQueryConnection représente une connexion de données secondaire créée dans InfoPath, qui spécifie toutes les informations nécessaires pour extraire des données d’une bibliothèque de documents ou d’une liste 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.
Notes
Le code écrit avec les membres de la classe SharePointListRWQueryConnection n’est pas compatible avec une connexion de données vers une bibliothèque de documents ou une liste SharePoint créée dans InfoPath 2003 ou 2007, ni avec une connexion de données dans un nouveau modèle de formulaire créé dans InfoPath 2010 avec l’un des Modèles de formulaires InfoPath 2007, ni avec une connexion de données convertie avec le bouton Convertir dans la version antérieure de la boîte de dialogue Connexions de données. Si vous n’avez pas besoin de maintenir la compatibilité avec une version antérieure d’InfoPath et voulez écrire du code avec les membres de la classe SharePointListRWQueryConnection, convertissez la connexion de données avec le bouton Convertir dans la version actuelle de la boîte de dialogue Connexions de données.
Notes
Pour créer une connexion de données primaire (principale) vers une liste SharePoint, vous pouvez créer un modèle de formulaire à partir du 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. Vous ne pouvez donc pas utiliser la classe SharePointListRWQueryConnection et ses membres pour travailler avec une connexion de données primaire vers une liste SharePoint.
La classe SharePointListRWQueryConnection fournit des propriétés qui permettent d’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 extrait les données.
L’objet SharePointListRWQueryConnection associé à la connexion de données est accessible via la propriété DataConnections de la classe XmlForm afin de renvoyer la connexion à partir de la DataConnectionCollection du modèle de formulaire.
La méthode Execute par défaut, héritée de la classe de base DataConnection, effectue une opération de requête ou d’envoi à l’aide des valeurs définies par déclaration dans le modèle de formulaire InfoPath au moment de la création. En outre, la classe SharePointListRWQueryConnection fournit la méthode Execute(XPathNavigator) qui permet de spécifier un emplacement différent pour l’insertion des données renvoyées.
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 propriété Item de la classe DataConnectionCollection pour récupérer un objet qui représente la connexion de données. Puis, l’objet renvoyé par la collection est converti vers le type SharePointListRWQueryConnection.
SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListRWQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListRWQueryConnection)
Après avoir défini la référence à la connexion de données, vous pouvez utiliser les propriétés ou les méthodes de l’objet SharePointListRWQueryConnection. L’exemple de code suivant définit une variable chaîne vers la valeur renvoyée par la propriété Name héritée de la classe de base DataConnection.
string spName = spConnection.Name;
Dim spName As String = spConnection.Name
Sécurité des threads
Tout membre static (Shared dans Visual Basic) public de ce type garantit la sécurité des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.