Asposecpplib
System::Xml::XmlCharacterData Class Referenceabstract

Serves as a base class for several classes that represent XML nodes that represent sequences of characters. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...

Inherits System::Xml::XmlNode.

Inherited by System::Xml::XmlCDataSection, System::Xml::XmlComment, and System::Xml::XmlText.

Public Member Functions

virtual ASPOSECPP_SHARED_API int get_Length () const =0
 Returns the length of the data in characters. More...
 
virtual String get_Data () const
 Returns the content of the node represented by the current object. More...
 
virtual void set_Data (String value)
 Sets the content of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void AppendData (String strData)
 Appends the specified string to the content of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void DeleteData (int offset, int count)
 Removes the specified substring from the content of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void InsertData (int offset, String strData)
 Insert the specified string at the specified position in the content string. More...
 
virtual ASPOSECPP_SHARED_API void ReplaceData (int offset, int count, String strData)
 Replaces the specified content string of the node represented by the current object with the specified string. More...
 
virtual ASPOSECPP_SHARED_API String Substring (int offset, int count)
 Returns the specified substring of the node's content string. More...
 
ASPOSECPP_SHARED_API XmlNode::Ptr CloneNode (bool deep) override
 NOT IMPLEMENTED. More...
 
- Public Member Functions inherited from System::Xml::XmlNode
virtual ASPOSECPP_SHARED_API String get_BaseURI () const
 NOT IMPLEMENTED. More...
 
virtual ASPOSECPP_SHARED_API XmlNodeType get_NodeType () const
 Returns the type of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_Name () const =0
 Returns the qualified name of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_Value () const
 Returns the value of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_LocalName () const
 Returns the local name of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_Prefix () const
 Returns the prefix of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_NamespaceURI () const
 Returns the namespace URI of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_InnerText () const
 Returns the concatenated values of the XML node represented by the current object and all its child nodes. More...
 
virtual ASPOSECPP_SHARED_API String get_InnerXml () const
 Returns the XML markup representing the child nodes of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String get_OuterXml () const
 Returns the XML markup representing the XML node represented by the current object and all its the child nodes. More...
 
virtual ASPOSECPP_SHARED_API bool get_HasChildNodes () const
 Determines if the XML node represented by the current object has child nodes. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr get_FirstChild () const
 Returns the first child of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr get_LastChild () const
 Returns the last child of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr get_NextSibling () const
 Returns the next sibling of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr get_PreviousSibling () const
 Returns the previous sibling of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr get_ParentNode () const
 Returns the parent node of the node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API SharedPtr< XmlDocumentget_OwnerDocument () const
 Returns a shared pointer to an XmlDocument object representing an XML document node to which the node represented by the current object belongs. More...
 
virtual ASPOSECPP_SHARED_API SharedPtr< XmlAttributeCollectionget_Attributes ()
 Returns an XmlAttributeCollection object containing all attributes of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API SharedPtr< XmlNodeListget_ChildNodes ()
 Returns an XmlNodeList object containing all child nodes of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void set_Value (String value)
 Sets the value of the node represented by the current object. More...
 
virtual void set_Prefix (String)
 Sets the prefix of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void set_InnerText (String value)
 Sets the XML node's inner text by replacing all the child nodes (if any) with the contents of the given string. More...
 
virtual ASPOSECPP_SHARED_API void set_InnerXml (String value)
 Replaces the XML node's inner XML markup with the contents of the specified string. More...
 
virtual SharedPtr< XmlElementidx_get (String) const
 Returns a shared pointer to the newly constructed XmlElement object. More...
 
virtual SharedPtr< XmlElementoperator[] (String name) const
 Returns a shared pointer to the XmlElement object representing the child element of the XML node represented by the current object with the specified qualified name. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr AppendChild (XmlNode::Ptr child)
 Adds the specified XML node at the end of the list of children of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr PrependChild (XmlNode::Ptr new_child)
 Adds the specified XML node at the beginning of the list of children of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr ReplaceChild (XmlNode::Ptr new_child, XmlNode::Ptr old_child)
 Replaces the specified the specified child node of the node reprsented by the current object with another one. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr InsertAfter (XmlNode::Ptr new_child, XmlNode::Ptr ref_child)
 Adds the specified XML node to the list of children of the XML node represented by the current object at the position next to the position of the specified reference child node. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr InsertBefore (XmlNode::Ptr new_child, XmlNode::Ptr ref_child)
 Adds the specified XML node to the list of children of the XML document represented by the current object at the position prior to the position of the specified reference child node. More...
 
virtual ASPOSECPP_SHARED_API void RemoveAll ()
 Removes all child nodes of the XML node reprsented by the current object. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr RemoveChild (XmlNode::Ptr child)
 Removes the specified child node of the XML node represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API String GetPrefixOfNamespace (const String &namespace_uri)
 Looks up the closest xmlns declaration for the specified namespace URI that is in scope for the XML node represented by the current object and returns the prefix defined in that declaration. More...
 
virtual ASPOSECPP_SHARED_API String GetNamespaceOfPrefix (const String &prefix)
 Looks up the closest xmlns declaration for the specified prefix that is in scope for the XML node represented by the current object and returns the namespace URI defined in that declaration. More...
 
virtual void WriteContentTo (SharedPtr< XmlWriter > writer)
 Saves all children of the XML node represented by the current object to the specified XmlWriter object. More...
 
virtual ASPOSECPP_SHARED_API void WriteTo (SharedPtr< XmlWriter > writer)=0
 Saves the XML node represented by the current object to the specified XmlWriter object. More...
 
virtual ASPOSECPP_SHARED_API SharedPtr< XmlNodeListSelectNodes (String xPath)
 Returns a list of XML nodes that match the specfied XPath expression. More...
 
virtual ASPOSECPP_SHARED_API SharedPtr< XmlNodeListSelectNodes (String xPath, SharedPtr< XmlNamespaceManager > nsMgr)
 Returns a list of XML nodes that match the specfied XPath expression; any prefixes encountered in xpath expression are resolved using the specified namespace manager. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr SelectSingleNode (String xPath)
 Returns the first XML node that match the specfied XPath expression. More...
 
virtual ASPOSECPP_SHARED_API XmlNode::Ptr SelectSingleNode (String xPath, SharedPtr< XmlNamespaceManager > nsMgr)
 Returns the first XML node that match the specfied XPath expression; any prefixes encountered in xpath expression are resolved using the specified namespace manager. More...
 
ASPOSECPP_SHARED_API SharedPtr< System::Collections::Generic::IEnumerator< XmlNode::Ptr > > GetEnumerator ()
 Returns an enumerator that points to the collection containing child nodes of the node represented by the current object. More...
 
XmlNode::Ptr Clone ()
 Returns a copy of the node represented by the current object. The subtree under the node is also copied. This method is equivallent to calling CloneNode(true). More...
 
xmlNode * native_node ()
 Returns a pointer to the underlying libxml2 xmlNode object. More...
 
virtual ASPOSECPP_SHARED_API SharedPtr< XPath::XPathNavigatorCreateNavigator () override
 Creates an instance of XPath::XPathNavigator class for navigating an XML document represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void Normalize ()
 Puts all XmlText nodes in the full depth of the sub-tree underneath this XmlNode into a "normal" form where only markup (that is, tags, comments, processing instructions, CDATA sections, and entity references) separates XmlText nodes, that is, there are no adjacent XmlText nodes. Not implemented. More...
 
- Public Member Functions inherited from System::Object
ASPOSECPP_SHARED_API Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ASPOSECPP_SHARED_API ~Object ()
 Destroys object. Frees all internal data structures. More...
 
ASPOSECPP_SHARED_API Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared refernce counter. More...
 
ASPOSECPP_SHARED_API void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
ASPOSECPP_SHARED_API void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual ASPOSECPP_SHARED_API bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual ASPOSECPP_SHARED_API int GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual ASPOSECPP_SHARED_API String ToString () const
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ASPOSECPP_SHARED_API ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual ASPOSECPP_SHARED_API const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual ASPOSECPP_SHARED_API bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual ASPOSECPP_SHARED_API void SetTemplateWeakPtr (unsigned int argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 Specialization of Object::ReferenceEquals for case of string and nullptr. More...
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 Specialization of Object::ReferenceEquals for case of strings. More...
 

Additional Inherited Members

- Public Types inherited from System::Xml::XmlNode
typedef SharedPtr< XmlNodePtr
 An alias for shared pointer to an instance of this class. More...
 
- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
typedef System::Details::SharedMembersType shared_members_type
 structure to keep list of shared pointers contained in object. More...
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Impleemnts C# typeof(System.Object) construct. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool Equals (double const &objA, double const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 

Detailed Description

Serves as a base class for several classes that represent XML nodes that represent sequences of characters. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Member Function Documentation

◆ AppendData()

virtual ASPOSECPP_SHARED_API void System::Xml::XmlCharacterData::AppendData ( String  strData)
virtual

Appends the specified string to the content of the node represented by the current object.

◆ CloneNode()

ASPOSECPP_SHARED_API XmlNode::Ptr System::Xml::XmlCharacterData::CloneNode ( bool  deep)
overridevirtual

NOT IMPLEMENTED.

Exceptions
NotImplementedExceptionAlways

Implements System::Xml::XmlNode.

◆ DeleteData()

virtual ASPOSECPP_SHARED_API void System::Xml::XmlCharacterData::DeleteData ( int  offset,
int  count 
)
virtual

Removes the specified substring from the content of the node represented by the current object.

Parameters
offset0-based index of the character of the node's content string at which the substring to remove begins
countThe number of characters to remove

◆ get_Data()

virtual String System::Xml::XmlCharacterData::get_Data ( ) const
inlinevirtual

Returns the content of the node represented by the current object.

Returns
The content of the node represented by the current object.

Reimplemented in System::Xml::XmlCDataSection.

◆ get_Length()

virtual ASPOSECPP_SHARED_API int System::Xml::XmlCharacterData::get_Length ( ) const
pure virtual

Returns the length of the data in characters.

Implemented in System::Xml::XmlCDataSection, System::Xml::XmlText, and System::Xml::XmlComment.

◆ InsertData()

virtual ASPOSECPP_SHARED_API void System::Xml::XmlCharacterData::InsertData ( int  offset,
String  strData 
)
virtual

Insert the specified string at the specified position in the content string.

Parameters
offset0-based index of the node's content string after which the specified string is inserted
strDataThe string to insert

◆ ReplaceData()

virtual ASPOSECPP_SHARED_API void System::Xml::XmlCharacterData::ReplaceData ( int  offset,
int  count,
String  strData 
)
virtual

Replaces the specified content string of the node represented by the current object with the specified string.

Parameters
offset0-based index of the character of the node's content string at which the substring to remove begins
countThe length of the substring to replace
strDataThe string to replace the content substring with

◆ set_Data()

virtual void System::Xml::XmlCharacterData::set_Data ( String  value)
inlinevirtual

Sets the content of the node represented by the current object.

Reimplemented in System::Xml::XmlCDataSection.

◆ Substring()

virtual ASPOSECPP_SHARED_API String System::Xml::XmlCharacterData::Substring ( int  offset,
int  count 
)
virtual

Returns the specified substring of the node's content string.

Parameters
offset0-based index of the character of the node's content string at which the substring to return begins
countThe length of the substring to return
Returns
The specified content substring