_XDocument3.DataObjects-Eigenschaft

Článek
04/27/2010

Ruft einen Verweis auf die DataObjectsCollection-Auflistung ab, die einem Microsoft Office InfoPath 2007-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 _XDocument3
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:

DataSourceObject myDataObject = 
   (DataSourceObject)thisXDocument.DataObjects["CityList"];

Dim myDataObject As DataSourceObject = _
   DirectCast(thisXDocument.DataObjects["CityList"], DataSourceObject)

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

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

Sdílet prostřednictvím