DataDOMEvent.Parent Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a reference to the XML Document Object Model (DOM) node of the parent of the XML DOM node being changed during a data validation event.
public:
property Microsoft::Office::Interop::InfoPath::SemiTrust::IXMLDOMNode ^ Parent { Microsoft::Office::Interop::InfoPath::SemiTrust::IXMLDOMNode ^ get(); };public Microsoft.Office.Interop.InfoPath.SemiTrust.IXMLDOMNode Parent { get; }member this.Parent : Microsoft.Office.Interop.InfoPath.SemiTrust.IXMLDOMNodePublic ReadOnly Property Parent As IXMLDOMNodeProperty Value
Examples
In the following partial example, the Parent property of the DataDOMEventObject object is used to check the name of the parent node; if it matches certain criteria, an error message is displayed:
[InfoPathEventHandler(MatchPath="/purchaseOrder/orderDate/shippingDate", EventType=InfoPathEventType.OnBeforeChange)]
public void shippingDate_OnBeforeChange(DataDOMEvent e)
{
if (e.<span class="label">Parent</span>.nodeName == "orderDate")
{
e.ReturnMessage = "You must delete the Ship Date before deleting the Order Date.";
e.ReturnStatus = false;
return;
}
}
Remarks
After you have set a reference to the XML DOM node that the Parent property returns, you can use any of the properties and methods that are supported by the XML DOM. This can be especially useful during delete operations, because the Parent property maps to the location of the XML DOM node that was removed.
Important: This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.