DataConnectionCollection.Item-Eigenschaft (Int32)
Ruft anhand des Indexwertes einen Verweis auf das angegebene DataConnection-Objekt aus der Auflistung ab.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride ReadOnly Default Property Item ( _
index As Integer _
) As DataConnection
Get
'Usage
Dim instance As DataConnectionCollection
Dim index As Integer
Dim value As DataConnection
value = instance(index)
public abstract DataConnection this[
int index
] { get; }
Parameter
- index
Typ: System.Int32
Der nullbasierte Index des abzurufenden DataConnection-Objekts.
Eigenschaftswert
Typ: Microsoft.Office.InfoPath.DataConnection
Das angegebene Objekt.
Hinweise
Nachdem Sie einen Verweis auf das DataConnection-Objekt festgelegt haben, das von der Item-Eigenschaft zurückgegeben wird, können Sie auf alle Eigenschaften oder Methoden dieses Objekts zugreifen, nachdem es in den geeigneten Typ für die entsprechende Datenverbindung umgewandelt wurde. Um beispielsweise auf die Eigenschaften und Methoden einer Datenverbindung zum Senden eines Formulars per E-Mail zuzugreifen, müssen Sie das zurückgegebene DataConnection-Objekt in den EmailSubmitConnection-Typ umwandeln.
Wichtig
Der Indexwert einer bestimmten Datenverbindung variiert möglicherweise von Version zu Version oder zwischen den Öffnungssitzungen derselben Formularvorlage in InfoPath und in einem Webbrowser (aus einer entsprechend konfigurierten Dokumentbibliothek in SharePoint Server 2010 mit InfoPath Forms Services). Damit zuverlässig unter allen Bedingungen dieselbe Datenverbindung geöffnet wird, sollten Sie deshalb die Datenverbindung mithilfe der DataConnectionCollection.Item[String]-Methode explizit anhand des Namens öffnen.
Auf den Member kann uneingeschränkt zugegriffen werden.
Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel wird das erste DataConnection-Objekt aus DataConnectionCollection abgerufen und dann in den EmailSubmitConnection-Typ umgewandelt.
// 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)
Siehe auch
Referenz
DataConnectionCollection Klasse