DataDOMEvent.Parent Property
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.
Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in Microsoft.Office.Interop.InfoPath.SemiTrust.dll)
Syntax
'Declaration
ReadOnly Property Parent As IXMLDOMNode
Get
'Usage
Dim instance As DataDOMEvent
Dim value As IXMLDOMNode
value = instance.Parent
IXMLDOMNode Parent { get; }
Property Value
Type: Microsoft.Office.Interop.InfoPath.SemiTrust.IXMLDOMNode
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.
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.Parent.nodeName == "orderDate")
{
e.ReturnMessage = "You must delete the Ship Date before deleting the Order Date.";
e.ReturnStatus = false;
return;
}
}