DataConnectionCollection.Item-Eigenschaft (Int32)

Artikel
04/27/2010

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
'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
Der nullbasierte Index des abzurufenden DataConnection-Objekts.

Eigenschaftswert

Der nullbasierte Index des abzurufenden DataConnection-Objekts.

Hinweise

Wenn Sie einen Verweis auf das DataConnection-Objekt festgelegt haben, das von der Item-Eigenschaft zurückgegeben wird, können Sie auf jede seiner Eigenschaften oder Methoden zugreifen, nachdem das Objekt 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 Microsoft Office Forms Server 2007 oder aus einer entsprechend konfigurierten Dokumentbibliothek in Office SharePoint Server 2007 mit InfoPath Forms Services). Um unter allen Bedingungen zuverlässig dieselbe Datenverbindung zu öffnen, sollten Sie die Datenverbindung explizit anhand des Namens mithilfe der DataConnectionCollection.Item(String)-Methode ö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 Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

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
DataConnectionCollection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über