add_reference Method

Creates a new XML reference to the specified XML element.

Syntax

def add_reference(target_xml_element: str, custom_id: str, auto_generate_id: bool) -> None: ...

Remarks

Use this method to add a reference to a particular XML element.

The reference's URI is set basing on the ID of the XML element. If the XML element doesn't have an ID then a CustomId value will be used. If CustomId is empty and AutoGenerateId is set, the ID will be generated automatically. An exception will be thrown otherwise.

Use canonicalization_method and hash_algorithm properties to specify the canonicalization method and hash algorithm to use.