System::Xml::XPath::XPathNavigator class

XPathNavigator class

Provides a cursor model for navigating and editing XML data.

class XPathNavigator : public System::Xml::XPath::XPathItem,
                       public System::Xml::XPath::IXPathNavigable,
                       public System::Xml::IXmlNamespaceResolver

Methods

MethodDescription
virtual AppendChild()Returns an XmlWriter object used to create one or more new child nodes at the end of the list of child nodes of the current node.
virtual AppendChild(String)Creates a new child node at the end of the list of child nodes of the current node using the XML data string specified.
virtual AppendChild(SharedPtr<XmlReader>)Creates a new child node at the end of the list of child nodes of the current node using the XML contents of the XmlReader object specified.
virtual AppendChild(SharedPtr<XPathNavigator>)Creates a new child node at the end of the list of child nodes of the current node using the nodes in the XPathNavigator specified.
virtual AppendChildElement(String, String, String, String)Creates a new child element node at the end of the list of child nodes of the current node using the namespace prefix, local name and namespace URI specified with the value specified.
virtual CheckValidity(SharedPtr<System::Xml::Schema::XmlSchemaSet>, System::Xml::Schema::ValidationEventHandler)Verifies that the XML data in the XPathNavigator conforms to the XML Schema definition language (XSD) schema provided.
virtual Clone()When overridden in a derived class, creates a new XPathNavigator positioned at the same node as this XPathNavigator.
virtual ComparePosition(SharedPtr<XPathNavigator>)Compares the position of the current XPathNavigator with the position of the XPathNavigator specified.
virtual Compile(String)Compiles a string representing an XPath expression and returns an XPathExpression object.
virtual CreateAttribute(String, String, String, String)Creates an attribute node on the current element node using the namespace prefix, local name and namespace URI specified with the value specified.
virtual CreateAttributes()Returns an XmlWriter object used to create new attributes on the current element.
CreateNavigator() overrideReturns a copy of the XPathNavigator.
virtual DeleteRange(SharedPtr<XPathNavigator>)Deletes a range of sibling nodes from the current node to the node specified.
virtual DeleteSelf()Deletes the current node and its child nodes.
virtual Evaluate(String)Evaluates the specified XPath expression and returns the typed result.
virtual Evaluate(String, SharedPtr<IXmlNamespaceResolver>)Evaluates the specified XPath expression and returns the typed result, using the IXmlNamespaceResolver object specified to resolve namespace prefixes in the XPath expression.
virtual Evaluate(SharedPtr<XPathExpression>)Evaluates the XPathExpression and returns the typed result.
virtual Evaluate(SharedPtr<XPathExpression>, SharedPtr<XPathNodeIterator>)Uses the supplied context to evaluate the XPathExpression, and returns the typed result.
virtual get_BaseURI()When overridden in a derived class, gets the base URI for the current node.
virtual get_CanEdit()Returns a value that indicates whether the XPathNavigator can edit the underlying XML data.
virtual get_HasAttributes()Returns a value that indicates whether the current node has any attributes.
virtual get_HasChildren()Returns a value that indicates whether the current node has any child nodes.
virtual get_InnerXml()Returns the markup representing the child nodes of the current node.
virtual get_IsEmptyElement()When overridden in a derived class, gets a value that indicates whether the current node is an empty element without an end element tag.
get_IsNode() overrideReturns a value that indicates if the current node represents an XPath node.
virtual get_LocalName()When overridden in a derived class, gets the XPathNavigator::get_Name of the current node without any namespace prefix.
virtual get_Name()When overridden in a derived class, gets the qualified name of the current node.
virtual get_NamespaceURI()When overridden in a derived class, gets the namespace URI of the current node.
virtual get_NameTable()When overridden in a derived class, gets the XmlNameTable of the XPathNavigator.
static get_NavigatorComparer()Returns an Collections::IEqualityComparer used for equality comparison of XPathNavigator objects.
virtual get_NodeType()When overridden in a derived class, gets the XPathNodeType of the current node.
virtual get_OuterXml()Returns the markup representing the opening and closing tags of the current node and its child nodes.
virtual get_Prefix()When overridden in a derived class, gets the namespace prefix associated with the current node.
virtual get_SchemaInfo()Returns the schema information that has been assigned to the current node as a result of schema validation.
get_TypedValue() overrideReturns the current node as a boxed object of the most appropriate type.
virtual get_UnderlyingObject()Used by XPathNavigator implementations which provide a “virtualized” XML view over a store, to provide access to underlying objects.
get_ValueAsBoolean() overrideReturns the current node’s value as a Boolean.
get_ValueAsDateTime() overrideReturns the current node’s value as a DateTime.
get_ValueAsDouble() overrideReturns the current node’s value as a Double.
get_ValueAsInt() overrideReturns the current node’s value as an Int32.
get_ValueAsLong() overrideReturns the current node’s value as an Int64.
get_ValueType() overrideReturns the type of the current node.
virtual get_XmlLang()Returns the xml:lang scope for the current node.
get_XmlType() overrideReturns the XmlSchemaType information for the current node.
virtual GetAttribute(String, String)Returns the value of the attribute with the specified local name and namespace URI.
virtual GetNamespace(String)Returns the value of the namespace node corresponding to the specified local name.
GetNamespacesInScope(XmlNamespaceScope) overrideReturns the in-scope namespaces of the current node.
virtual InsertAfter()Returns an XmlWriter object used to create a new sibling node after the currently selected node.
virtual InsertAfter(String)Creates a new sibling node after the currently selected node using the XML string specified.
virtual InsertAfter(SharedPtr<XmlReader>)Creates a new sibling node after the currently selected node using the XML contents of the XmlReader object specified.
virtual InsertAfter(SharedPtr<XPathNavigator>)Creates a new sibling node after the currently selected node using the nodes in the XPathNavigator object specified.
virtual InsertBefore()Returns an XmlWriter object used to create a new sibling node before the currently selected node.
virtual InsertBefore(String)Creates a new sibling node before the currently selected node using the XML string specified.
virtual InsertBefore(SharedPtr<XmlReader>)Creates a new sibling node before the currently selected node using the XML contents of the XmlReader object specified.
virtual InsertBefore(SharedPtr<XPathNavigator>)Creates a new sibling node before the currently selected node using the nodes in the XPathNavigator specified.
virtual InsertElementAfter(String, String, String, String)Creates a new sibling element after the current node using the namespace prefix, local name and namespace URI specified, with the value specified.
virtual InsertElementBefore(String, String, String, String)Creates a new sibling element before the current node using the namespace prefix, local name, and namespace URI specified, with the value specified.
virtual IsDescendant(SharedPtr<XPathNavigator>)Determines whether the specified XPathNavigator is a descendant of the current XPathNavigator.
virtual IsSamePosition(SharedPtr<XPathNavigator>)When overridden in a derived class, determines whether the current XPathNavigator is at the same position as the specified XPathNavigator.
LookupNamespace(const String&) overrideReturns the namespace URI for the specified prefix.
LookupPrefix(const String&) overrideReturns the prefix declared for the specified namespace URI.
virtual Matches(SharedPtr<XPathExpression>)Determines whether the current node matches the specified XPathExpression.
virtual Matches(String)Determines whether the current node matches the specified XPath expression.
virtual MoveTo(SharedPtr<XPathNavigator>)When overridden in a derived class, moves the XPathNavigator to the same position as the specified XPathNavigator.
virtual MoveToAttribute(String, String)Moves the XPathNavigator to the attribute with the matching local name and namespace URI.
virtual MoveToChild(String, String)Moves the XPathNavigator to the child node with the local name and namespace URI specified.
virtual MoveToChild(XPathNodeType)Moves the XPathNavigator to the child node of the XPathNodeType specified.
virtual MoveToFirst()Moves the XPathNavigator to the first sibling node of the current node.
virtual MoveToFirstAttribute()When overridden in a derived class, moves the XPathNavigator to the first attribute of the current node.
virtual MoveToFirstChild()When overridden in a derived class, moves the XPathNavigator to the first child node of the current node.
virtual MoveToFirstNamespace(XPathNamespaceScope)When overridden in a derived class, moves the XPathNavigator to the first namespace node that matches the XPathNamespaceScope specified.
MoveToFirstNamespace()Moves the XPathNavigator to first namespace node of the current node.
virtual MoveToFollowing(String, String)Moves the XPathNavigator to the element with the local name and namespace URI specified in document order.
virtual MoveToFollowing(String, String, SharedPtr<XPathNavigator>)Moves the XPathNavigator to the element with the local name and namespace URI specified, to the boundary specified, in document order.
virtual MoveToFollowing(XPathNodeType)Moves the XPathNavigator to the following element of the XPathNodeType specified in document order.
virtual MoveToFollowing(XPathNodeType, SharedPtr<XPathNavigator>)Moves the XPathNavigator to the following element of the XPathNodeType specified, to the boundary specified, in document order.
virtual MoveToId(String)When overridden in a derived class, moves to the node that has an attribute of type ID whose value matches the specified String.
virtual MoveToNamespace(String)Moves the XPathNavigator to the namespace node with the specified namespace prefix.
virtual MoveToNext()When overridden in a derived class, moves the XPathNavigator to the next sibling node of the current node.
virtual MoveToNext(String, String)Moves the XPathNavigator to the next sibling node with the local name and namespace URI specified.
virtual MoveToNext(XPathNodeType)Moves the XPathNavigator to the next sibling node of the current node that matches the XPathNodeType specified.
virtual MoveToNextAttribute()When overridden in a derived class, moves the XPathNavigator to the next attribute.
virtual MoveToNextNamespace(XPathNamespaceScope)When overridden in a derived class, moves the XPathNavigator to the next namespace node matching the XPathNamespaceScope specified.
MoveToNextNamespace()Moves the XPathNavigator to the next namespace node.
virtual MoveToParent()When overridden in a derived class, moves the XPathNavigator to the parent node of the current node.
virtual MoveToPrevious()When overridden in a derived class, moves the XPathNavigator to the previous sibling node of the current node.
virtual MoveToRoot()Moves the XPathNavigator to the root node that the current node belongs to.
virtual PrependChild()Returns an XmlWriter object used to create a new child node at the beginning of the list of child nodes of the current node.
virtual PrependChild(String)Creates a new child node at the beginning of the list of child nodes of the current node using the XML string specified.
virtual PrependChild(SharedPtr<XmlReader>)Creates a new child node at the beginning of the list of child nodes of the current node using the XML contents of the XmlReader object specified.
virtual PrependChild(SharedPtr<XPathNavigator>)Creates a new child node at the beginning of the list of child nodes of the current node using the nodes in the XPathNavigator object specified.
virtual PrependChildElement(String, String, String, String)Creates a new child element at the beginning of the list of child nodes of the current node using the namespace prefix, local name, and namespace URI specified with the value specified.
virtual ReadSubtree()Returns an XmlReader object that contains the current node and its child nodes.
virtual ReplaceRange(SharedPtr<XPathNavigator>)Replaces a range of sibling nodes from the current node to the node specified.
virtual ReplaceSelf(String)Replaces the current node with the content of the string specified.
virtual ReplaceSelf(SharedPtr<XmlReader>)Replaces the current node with the contents of the XmlReader object specified.
virtual ReplaceSelf(SharedPtr<XPathNavigator>)Replaces the current node with the contents of the XPathNavigator object specified.
virtual Select(String)Selects a node set, using the specified XPath expression.
virtual Select(String, SharedPtr<IXmlNamespaceResolver>)Selects a node set using the specified XPath expression with the IXmlNamespaceResolver object specified to resolve namespace prefixes.
virtual Select(SharedPtr<XPathExpression>)Selects a node set using the specified XPathExpression.
virtual SelectAncestors(XPathNodeType, bool)Selects all the ancestor nodes of the current node that have a matching XPathNodeType.
virtual SelectAncestors(String, String, bool)Selects all the ancestor nodes of the current node that have the specified local name and namespace URI.
virtual SelectChildren(XPathNodeType)Selects all the child nodes of the current node that have the matching XPathNodeType.
virtual SelectChildren(String, String)Selects all the child nodes of the current node that have the local name and namespace URI specified.
virtual SelectDescendants(XPathNodeType, bool)Selects all the descendant nodes of the current node that have a matching XPathNodeType.
virtual SelectDescendants(String, String, bool)Selects all the descendant nodes of the current node with the local name and namespace URI specified.
virtual SelectSingleNode(String)Selects a single node in the XPathNavigator using the specified XPath query.
virtual SelectSingleNode(String, SharedPtr<IXmlNamespaceResolver>)Selects a single node in the XPathNavigator object using the specified XPath query with the IXmlNamespaceResolver object specified to resolve namespace prefixes.
virtual SelectSingleNode(SharedPtr<XPathExpression>)Selects a single node in the XPathNavigator using the specified XPathExpression object.
virtual set_InnerXml(String)Sets the markup representing the child nodes of the current node.
virtual set_OuterXml(String)Sets the markup representing the opening and closing tags of the current node and its child nodes.
virtual SetTypedValue(SharedPtr<Object>)Sets the typed value of the current node.
virtual SetValue(String)Sets the value of the current node.
ToString() const overrideReturns the text value of the current node.
ValueAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>) overrideReturns the current node’s value as the Type specified, using the IXmlNamespaceResolver object specified to resolve namespace prefixes.
virtual WriteSubtree(SharedPtr<XmlWriter>)Streams the current node and its child nodes to the XmlWriter object specified.

Typedefs

TypedefDescription
PtrAn alias for shared pointer to an instance of this class.

See Also