Freigeben über


_XDocument4.DataObjects Eigenschaft

Definition

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

public:
 property Microsoft::Office::Interop::InfoPath::DataObjectsCollection ^ DataObjects { Microsoft::Office::Interop::InfoPath::DataObjectsCollection ^ get(); };
public Microsoft.Office.Interop.InfoPath.DataObjectsCollection DataObjects { get; }
member this.DataObjects : Microsoft.Office.Interop.InfoPath.DataObjectsCollection
Public ReadOnly Property DataObjects As DataObjectsCollection

Eigenschaftswert

Gibt zurück DataObjectsCollection.

Implementiert

Beispiele

Im folgenden Beispiel wird die DataObjects-Eigenschaft des XDocument -Objekts verwendet, um einen Verweis auf die sekundäre Datenquelle "CityList" festzulegen:

DataSourceObject myDataObject = 
   (DataSourceObject)thisXDocument.<span class="label">DataObjects</span>["CityList"];
Dim myDataObject As DataSourceObject = _
   DirectCast(thisXDocument.<span class="label">DataObjects</span>["CityList"], DataSourceObject)

Im folgenden Beispiel, das als OnClick Ereignishandler für eine Schaltfläche in einem Formular implementiert wird, wird die DataObjects-Eigenschaft des XDocument -Objekts verwendet, um einen Verweis auf die DataObjectsCollection Auflistung festzulegen. Der Code durchläuft dann eine Schleife durch die Auflistung und zeigt den Positionsindex und den Namen jedes DataSourceObject objekts an, das er enthält:

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

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

Im folgenden Beispiel wird die DataObjects-Eigenschaft des XDocument -Objekts verwendet, um einen Verweis auf die sekundäre Datenquelle "CityList" festzulegen:

DataSourceObject myDataObject = 
   (DataSourceObject)thisXDocument.<span class="label">DataObjects</span>["CityList"];
Dim myDataObject As DataSourceObject = _
   DirectCast(thisXDocument.<span class="label">DataObjects</span>["CityList"], DataSourceObject)

Im folgenden Beispiel, das als OnClick Ereignishandler für eine Schaltfläche in einem Formular implementiert wird, wird die DataObjects-Eigenschaft des XDocument -Objekts verwendet, um einen Verweis auf die DataObjectsCollection Auflistung festzulegen. Der Code durchläuft dann eine Schleife durch die Auflistung und zeigt den Positionsindex und den Namen jedes DataSourceObject objekts an, das er enthält:

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

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

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 in der DataObjects-Auflistung enthalten.

Gilt für: