_XDocument2.DataObjects Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 < 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 < 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.