_XDocument4.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 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 < 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 < 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.