SharepointListQueryConnection, classe
REMARQUE : cette API est maintenant obsolète.
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.SharepointListQueryConnection
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
<ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")> _
Public MustInherit Class SharepointListQueryConnection _
Inherits DataConnection
'Utilisation
Dim instance As SharepointListQueryConnection
[ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : DataConnection
Remarques
Important
La classe SharepointListQueryConnection et ses membres sont obsolètes dans Microsoft InfoPath 2010. Le code écrit avec les membres de cette classe est compatible uniquement avec une connexion de données vers une bibliothèque de documents SharePoint créée dans InfoPath 2003 ou InfoPath 2007, à l’aide d’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 ou 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. Pour écrire du code qui fonctionne avec une connexion de données à une bibliothèque de documents SharePoint créée dans un modèle de formulaire InfoPath 2010, utilisez les membres de la classe SharePointListRWQueryConnection. De plus, si vous convertissez une connexion de données à une bibliothèque de documents SharePoint à l’aide du bouton Convertir dans la version actuelle de la boîte de dialogue Connexions de données, vous devez réécrire tout code écrit avec les membres de la classe SharepointListQueryConnection pour utiliser à la place les membres de la classe SharePointListRWQueryConnection.
L’objet SharePointListQueryConnection représente une connexion de données créée dans InfoPath à l’aide de l’Assistant de connexion de données qui spécifie toutes les informations nécessaires à l’extraction des données d’une liste ou bibliothèque de documents SharePoint.
La classe SharePointListQueryConnection fournit des propriétés qui peuvent servir à obtenir le nom de la connexion de données et l’URL de la liste ou bibliothèque de documents sur le site Windows SharePoint Services à partir duquel la connexion extrait des données.
L’objet SharePointListQueryConnection associé à la connexion de données est accessible via la propriété DataConnections de la classe XmlForm pour renvoyer la connexion depuis la collection 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 en mode Création dans InfoPath. En outre, la classe SharePointListQueryConnection comprend la méthode SharepointListQueryConnection.Execute, qui permet de spécifier un emplacement différent pour l’insertion des données renvoyées.
La classe SharePointListQueryConnection correspond à l’interface SharePointListAdapterObject du modèle objet de Microsoft Office InfoPath 2003.
Exemples
Dans l’exemple suivant, une référence à l’objet SharePointListQueryConnection qui représente la connexion appelée « Contacts », qui se connecte à une liste d’informations de contact sur SharePoint, est définie par transmission du nom à la propriété Item de la classe DataConnectionCollection, puis en attribuant le type SharePointListQueryConnection à l’objet renvoyé.
[C#]
SharePointListQueryConnection spConnection = (SharePointListQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListQueryConnection)
Après avoir défini la référence, vous pouvez utiliser les propriétés de l’objet SharePointListQueryConnection. L’exemple suivant définit une variable de chaîne avec 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.