DataConnectionCollection.Item[] Eigenschaft

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Überlädt

Item[Int32]	Ruft einen Verweis auf das angegebene DataConnection -Objekt aus der Auflistung anhand des Indexwerts ab.
Item[String]	Ruft anhand des Namens einen Verweis auf das angegebene DataConnection -Objekt aus der Auflistung ab.

Item[Int32]

Ruft einen Verweis auf das angegebene DataConnection -Objekt aus der Auflistung anhand des Indexwerts ab.

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

Parameter

index

Int32

Der nullbasierte Index des DataConnection abzurufenden Objekts.

Eigenschaftswert

DataConnection

Das angegebene Objekt.

Beispiele

Im folgenden Beispiel wird das erste DataConnection Objekt aus DataConnectionCollectiondem 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)

Hinweise

Nachdem Sie einen Verweis auf das DataConnection Objekt festgelegt haben, das die Item-Eigenschaft zurückgibt, können Sie auf eine seiner Eigenschaften oder Methoden zugreifen, nachdem das Objekt in den entsprechenden Typ für die entsprechende Datenverbindung umgewandelt wurde. Wenn Sie beispielsweise auf die Eigenschaften und Methoden einer Datenverbindung zum Senden eines Formulars in E-Mail zugreifen möchten, müssen Sie das zurückgegebene DataConnection Objekt in den EmailSubmitConnection Typ umwandeln.

Wichtig: Es ist nicht garantiert, dass der Indexwert einer bestimmten Datenverbindung zwischen Versionen oder zwischen Sitzungen zum Öffnen derselben Formularvorlage in InfoPath und in einem Webbrowser (aus einer entsprechend konfigurierten Dokumentbibliothek auf SharePoint Server 2010 unter InfoPath Forms Services) identisch ist. Um die gleiche Datenverbindung unter allen Bedingungen zuverlässig zu öffnen, sollten Sie die Datenverbindung explizit anhand des Namens öffnen, indem Sie stattdessen die Item[String] -Methode verwenden.

Auf dieses Mitglied kann uneingeschränkt zugegriffen werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Item[String]

Ruft anhand des Namens einen Verweis auf das angegebene DataConnection -Objekt aus der Auflistung ab.

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

Parameter

name

String

Der Name des DataConnection abzurufenden Objekts.

Eigenschaftswert

DataConnection

Das angegebene Objekt.

Beispiele

Im folgenden Beispiel wird das Objekt mit dem DataConnection Namen "Employees" aus DataConnectionCollectionabgerufen und dann in den AdoQueryConnection Typ umgewandelt (der eine Datenverbindung zum Abrufen von Daten aus einer Access- oder SQL Server-Datenbank darstellt).

// 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)

Hinweise

Nachdem Sie einen Verweis auf das DataConnection Objekt festgelegt haben, das die Item-Eigenschaft zurückgibt, können Sie auf eine seiner Eigenschaften oder Methoden zugreifen, nachdem das Objekt in den entsprechenden Typ für die entsprechende Datenverbindung umgewandelt wurde. Wenn Sie beispielsweise auf die Eigenschaften und Methoden einer Datenverbindung zum Senden eines Formulars in E-Mail zugreifen möchten, müssen Sie das zurückgegebene DataConnection Objekt in den EmailSubmitConnection Typ umwandeln.

Auf dieses Mitglied kann uneingeschränkt zugegriffen werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.