Description
Returns the PBDOM_DOCUMENT object that owns the PBDOM_ATTRIBUTE.
Syntax
pbdom_attribute_name.GetOwnerDocumentObject()
Return value
PBDOM_DOCUMENT. The PBDOM_DOCUMENT that owns the PBDOM_ATTRIBUTE object from which the GetOwnerDocumentObject method is invoked.
A return value of null indicates the PBDOM_ATTRIBUTE object is not owned by any PBDOM_DOCUMENT.
Examples
The GetOwnerDocumentObject method can be used to identify the PBDOM_DOCUMENT object that owns a PBDOM_ATTRIBUTE object.
Here, the BuildFromString method is used to create the following PBDOM_DOCUMENT object, pbdom_doc, using an XML string:
<abc My_Attr="My Attribute Value"> <data>Data </data> </abc>
The GetAttribute method is used to obtain the attribute from the root element of pbdom_doc. This value is assigned to the PBDOM_ATTRIBUTE object pbdom_attr. The GetOwnerDocumentObject method is used to obtain the pbdom_doc that owns pbdom_attr. The result of the GetOwnerDocumentObject method is assigned to the PBDOM_DOCUMENT object pbdom_doc_2. Then pbdom_doc_2 is compared to pbdom_doc using the Equals method, and the result is displayed in a message box.
PBDOM_Builder pbdombuilder_new
pbdom_document pbdom_doc
pbdom_document pbdom_doc_2
PBDOM_ATTRIBUTE pbdom_attr
string strXML = "<abc My_Attr=~"My Attribute Value~"><data>Data </data></abc>"
TRY
pbdombuilder_new = Create PBDOM_Builder
pbdom_doc = pbdombuilder_new.BuildFromString (strXML)
pbdom_attr = pbdom_doc.GetRootElement(). &
GetAttribute("My_Attr")
pbdom_doc_2 = pbdom_attr.GetOwnerDocumentObject()
if (pbdom_doc.Equals(pbdom_doc_2)) then
MessageBox ("Equals", "pbdom_doc equals " &
+ "pbdom_attr.GetOwnerDocumentObject()")
end if
Destroy pbdombuilder_new
CATCH (PBDOM_Exception except)
MessageBox ("Exception Occurred", except.Text)
END TRY
See also
