NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

XmlNavigator Methods

The methods of the XmlNavigator class are listed below. For a complete list of XmlNavigator class members, see the XmlNavigator Members topic.

Public:

Clone Creates a new XmlNavigator positioned at the same node as this XmlNavigator.
Compile Compiles the given XPath expression and returns an object representing that expression.
CopyChildren Copies all the children from current position of the specified XmlNavigator and inserts them at the specified position in this XmlNavigator.
CopySelected Copies all the selected nodes from the specified XmlNavigator (as returned by MoveToNextSelected) and inserts them at the specified position in this tree.
Equals (inherited from Object) Determines whether the specified Object is the same instance as the current Object. Subclasses are expected to override this method to support value equality (not reference equality).
Evaluate Evaluates the given expression and returns the typed result (int, boolean or string).
GetAttribute Overloaded. Gets the value of an attribute.
GetHashCode (inherited from Object) Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table.
GetType (inherited from Object) Gets the Type of the Object.
HasAttribute Overloaded. Determines whether the current node has the specified attribute.
Insert Overloaded. Inserts node(s) at the specified position.
IsSamePosition Determines whether this XmlNavigator is at the same position as the specified XmlNavigator.
LookupPrefix Looks up the prefix for the given namespace URI as defined higher up in the tree.
Matches Determines whether the current node matches the specified XPath expression
Move Moves the entire subtree point to in the specified XmlNavigator to the specified position in this XmlNavigator.
MoveChildren Moves all the children from current position of the specified XmlNavigator and inserts them at the specified position in this XmlNavigator.
MoveSelected Moves all the selected nodes from the specified XmlNavigator (as returned by MoveToNextSelected) and inserts them at the specified position in this XmlNavigato. This navagitor's position is unaffected by this operation.
MoveTo Moves to the same position as the specified XmlNavigator.
MoveToAttribute Overloaded. Move to the specified attribute.

The MoveToAttribute methods enable you to get both random access to attributes and strongly typed access to attribute values.

To get strongly typed access to an attribute value, you must do the following:

  1. Call MoveToAttribute to move to the attribute whose value you want to access.
  2. Call Read method for the data type you want (for example, ReadBoolean for boolean, ReadDate for DateTime, and so on).

After calling MoveToAttribute, the Name, Namespace, Prefix properties will reflect the properties of that attribute.

MoveToChild Moves to the specified child node of the current node (index 0 is the first child).
MoveToDocument Moves to the document node that owns this node.
MoveToDocumentElement Moves to the child element node of the owning document.
MoveToElement Moves to the element that contains the current attribute node.
MoveToFirst Moves to the first sibling of the current node.
MoveToFirstAttribute Moves to the first attribute.
MoveToFirstChild Moves to the first child of the current node.
MoveToFirstSelected Moves the XmlNavigator to the first node in the selected set.
MoveToId Moves to the node with an ID attribute whose value matches the specified string.
MoveToLast Moves to the last sibling of the current node.
MoveToLastChild Moves to the last child of the current node.
MoveToLastSelected Moves the XmlNavigator to the last node in the selected set.
MoveToNext Moves to the next sibling of the current node.
MoveToNextAttribute Moves to the next attribute.
MoveToNextSelected Moves the XmlNavigator to the next node in the selected set.
MoveToParent Moves to the parent of the current node.
MoveToPrevious Moves to the previous sibling of the current node.
MoveToPreviousSelected Moves the XmlNavigator to the previous node in the selected set.
PopPosition Moves the XmlNavigator back to a previously pushed position and pops that saved position off the stack.
PushPosition Saves the current position.
Remove Overloaded. Removes the specified node(s).
RemoveSelected Removes all the selected nodes.
Select Selects a new set of "records" using the specified XPath expression.
SelectSingle Selects the first node that matches the specified expression.
SetAttribute Overloaded. Sets the value of the specified attribute.
ToString (inherited from Object) Returns a String that represents the current Object.

Protected:

Finalize (inherited from Object) Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by the Garbage Collector (GC). This method may be ignored by the runtime; therefore, necessary cleanup operations should be done elsewhere.
MemberwiseClone (inherited from Object) Creates a shallow copy of the current Object.

See Also

XmlNavigator Class | System.NewXml Namespace