_XDocument2.DataObjects-Eigenschaft

Článek
04/27/2010

Ruft einen Verweis auf die DataObjectsCollection-Auflistung ab, die einem Formular zugeordnet ist.

Diese Eigenschaft ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(18)> _
ReadOnly Property DataObjects As DataObjectsCollection
'Usage
Dim instance As _XDocument2
Dim value As DataObjectsCollection

value = instance.DataObjects

[DispIdAttribute(18)] 
DataObjectsCollection DataObjects { get; }

Hinweise

Die DataObjects-Auflistung ermöglicht den programmgesteuerten Zugriff auf die sekundären Datenquellen eines Formulars. Jede sekundäre Datenquelle ist in einem DataSourceObject-Objekt innerhalb der DataObjects-Auflistung enthalten.

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Beispiel

Im folgenden Beispiel wird die DataObjects-Eigenschaft des XDocument-Objekts zum Festlegen eines Verweises auf die sekundäre Datenquelle "CityList" verwendet:

object objDataObject;
objDataObject = thisXDocument.DataObjects["CityList"];

Im folgenden Beispiel, das als OnClick-Ereignishandler für eine Schaltfläche in einem Formular implementiert ist, dient die DataObjects-Eigenschaft des XDocument-Objekts zum Festlegen eines Verweises auf die DataObjectsCollection-Auflistung. Anschließend durchläuft der Code die Auflistung in einer Schleife und zeigt den positionellen Index und den Namen jedes in der Auflistung enthaltenen DataSourceObject-Objekts an:

[InfoPathEventHandler(MatchPath="ShowDataObjectNames", EventType=InfoPathEventType.OnClick)]
public void ShowDataObjectNames_OnClick(DocActionEvent e)
{
 // Set a reference to the DataObjects collection.
 DataObjectsCollection dataObjects = thisXDocument.DataObjects;

 // Loop through the collection and display the name
 // of each DataObject object that it contains.
 for (int i=0; i < dataObjects.Count; i++)
 {
  thisXDocument.UI.Alert("Data object " + i + ": " + dataObjects[i].Name);
 }
}

Siehe auch

Referenz

_XDocument2-Schnittstelle
_XDocument2-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím