DataConnectionCollection.Item[] Propriété

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Surcharges

Item[Int32]	Obtient une référence à l’objet spécifié DataConnection à partir de la collection par valeur d’index.
Item[String]	Obtient une référence à l’objet spécifié DataConnection à partir de la collection par son nom.

Item[Int32]

Obtient une référence à l’objet spécifié DataConnection à partir de la collection par valeur d’index.

public:
 abstract property Microsoft::Office::InfoPath::DataConnection ^ default[int] { Microsoft::Office::InfoPath::DataConnection ^ get(int index); };

public abstract Microsoft.Office.InfoPath.DataConnection this[int index] { get; }

member this.Item(int) : Microsoft.Office.InfoPath.DataConnection

Default Public MustOverride ReadOnly Property Item(index As Integer) As DataConnection

Paramètres

index

Int32

Index de base zéro de l’objet DataConnection à obtenir.

Valeur de propriété

DataConnection

L'objet spécifié.

Exemples

Dans l’exemple suivant, le premier DataConnection objet est récupéré à partir du DataConnectionCollection, puis converti en EmailSubmitConnection type .

// Get the first connection from the 
// DataConnections collection.
EmailSubmitConnection myEmailSubmitConnection =
   (EmailSubmitConnection)(this.DataConnections[0]);

' Get the first connection from the 
' DataConnections collection.
Dim myEmailSubmitConnection As EmailSubmitConnection = _
   DirectCast(Me.DataConnections(0), EmailSubmitConnection)

Remarques

Une fois que vous avez défini une référence à l’objet DataConnection retourné par la propriété Item , vous pouvez accéder à l’une de ses propriétés ou méthodes une fois que l’objet a été converti en type approprié pour la connexion de données correspondante. Par exemple, pour accéder aux propriétés et méthodes d’une connexion de données pour l’envoi d’un formulaire par courrier électronique, vous devez convertir l’objet retourné DataConnection en EmailSubmitConnection type.

Important : il n’est pas garanti que la valeur d’index d’une connexion de données donnée soit identique entre les versions ou entre les sessions d’ouverture du même modèle de formulaire dans InfoPath et dans un navigateur Web (à partir d’une bibliothèque de documents configurée de manière appropriée sur SharePoint Server 2010 exécutant InfoPath Forms Services). Pour ouvrir de manière fiable la même connexion de données dans toutes les conditions, vous devez ouvrir la connexion de données explicitement par nom à l’aide de la méthode à la Item[String] place.

Vous pouvez accéder à ce membre sans restrictions.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

Item[String]

Obtient une référence à l’objet spécifié DataConnection à partir de la collection par son nom.

public:
 abstract property Microsoft::Office::InfoPath::DataConnection ^ default[System::String ^] { Microsoft::Office::InfoPath::DataConnection ^ get(System::String ^ name); };

public abstract Microsoft.Office.InfoPath.DataConnection this[string name] { get; }

member this.Item(string) : Microsoft.Office.InfoPath.DataConnection

Default Public MustOverride ReadOnly Property Item(name As String) As DataConnection

Paramètres

name

String

Nom de l’objet DataConnection à obtenir.

Valeur de propriété

DataConnection

L'objet spécifié.

Exemples

Dans l’exemple suivant, l’objet DataConnection nommé « Employees » est récupéré à partir du DataConnectionCollection, puis converti en AdoQueryConnection type (qui représente une connexion de données pour récupérer des données à partir d’une base de données Access ou SQL Server).

// Get the Employees connection from the 
// DataConnections collection.
AdoQueryConnection myAdoQueryConnection =
   (AdoQueryConnection)(this.DataConnections["Employees"]);

' Get the Employees connection from the 
' DataConnections collection.
Dim myAdoQueryConnection As AdoQueryConnection = _
   DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

Remarques

Une fois que vous avez défini une référence à l’objet DataConnection retourné par la propriété Item , vous pouvez accéder à l’une de ses propriétés ou méthodes une fois que l’objet a été converti en type approprié pour la connexion de données correspondante. Par exemple, pour accéder aux propriétés et méthodes d’une connexion de données pour l’envoi d’un formulaire par courrier électronique, vous devez convertir l’objet retourné DataConnection en EmailSubmitConnection type.

Vous pouvez accéder à ce membre sans restrictions.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.