Freigeben über


_XDocument2.DataObjects Eigenschaft

Definition

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

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

Eigenschaftswert

Implementiert

Beispiele

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

object objDataObject;
objDataObject = thisXDocument.<span class="label">DataObjects</span>["CityList"];

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:

object objDataObject;
objDataObject = thisXDocument.<span class="label">DataObjects</span>["CityList"];

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.

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

Gilt für: