SharepointListQueryConnection Classe

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Attention

The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.

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

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

[System.Obsolete("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : Microsoft.Office.InfoPath.DataConnection

type SharepointListQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharepointListQueryConnection
Inherits DataConnection

Héritage

Object

DataConnection

SharepointListQueryConnection

Attributs

ObsoleteAttribute

Exemples

Dans l’exemple suivant, une référence à l’objet SharePointListQueryConnection qui représente la connexion nommée « Contacts », qui se connecte à une liste d’informations de contact sur SharePoint, est définie en passant le nom à la Item[String] propriété de la classe DataConnectionCollection , puis en cassant l’objet retourné au type SharePointListQueryConnection .

[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 sur la valeur retournée par la Name propriété héritée de la classe de base DataConnection .

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

Remarques

Important : la SharepointListQueryConnection classe et ses membres ont été dépréciés dans Microsoft InfoPath. Le code écrit avec les membres de cette classe est compatible uniquement avec une connexion de données à une 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. 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, utilisez les membres de la SharePointListRWQueryConnection classe . En outre, si vous convertissez une connexion de données en bibliothèque de documents SharePoint avec le bouton Convertir en version actuelle dans la boîte de dialogue Connections de données, vous devez réécrire tout code écrit avec les membres de la SharepointListQueryConnection classe pour utiliser les membres de la classe à la SharePointListRWQueryConnection place.

L’objet SharePointListQueryConnection représente une connexion de données secondaire créée dans InfoPath à l’aide de l’Assistant Connexion de données 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.

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 à l’aide de la DataConnections propriété de la XmlForm classe pour renvoyer 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 en mode création de modèle de formulaire InfoPath. En outre, la classe SharePointListQueryConnection fournit la Execute(XPathNavigator) méthode , qui vous permet de spécifier un autre emplacement pour insérer les données retournées.

La classe SharePointListQueryConnection correspond à l’interface SharePointListAdapterObject du modèle objet de Microsoft Office InfoPath 2003.

Constructeurs

SharepointListQueryConnection()

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

Propriétés

Name	Obsolète. Obtient le nom de la connexion de données. (Hérité de DataConnection)
QueryThisFormOnly	Obsolète. Indique si l’opération de requête ne s’applique qu’au formulaire actif.
SiteUrl	Obsolète. Obtient un objet System.Uri qui représente l’URL (Uniform Resource Locator) du site Windows SharePoint Services associé à l’objetSharepointListQueryConnection.

Méthodes

Execute()	Obsolète. 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)	Obsolète. Remplace la méthode par défaut Execute() pour permettre la spécification d’un autre emplacement pour insérer les données retournées.