IXMLDOMNode.replaceChild (Visual Basic .NET)

The replaceChild method replaces the specified old child node with the supplied new child node.

IXMLDOMNode = IXMLDOMNode.replaceChild(
  objnewChild As Object,
  objoldChild As Object
)

Arguments

objnewChild	[in] Object containing the address of the new child that is to replace the old child. If NULL, objoldChild is removed without a replacement.
objoldChild	[in] Object containing the address of the old child that is to be replaced by the new child.

Return Value

When getting the value, this method returns the old child node that is replaced by the new child node.

Remarks

When replacing an old child node with a new child node, the new child must be a valid child type for the existing parent node. The following tables list which child node types are valid and not valid for the parent node types specified.

The following table lists possible child node types for the parent node type NODE_ATTRIBUTE.

Child node type	Description
NODE_ATTRIBUTE NODE_COMMENT NODE_ELEMENT	Not valid. Returns an error. These node types cannot be children of an attribute.
NODE_PROCESSING_INSTRUCTION	Not valid. Returns an error. This node type either cannot be a child of an attribute node or it is read-only.
NODE_TEXT	Replaces the specified objoldChild with the supplied objnewChild and returns objoldChild.

The following table lists possible child node types for the parent node type NODE_DOCUMENT.

Child node type	Description
NODE_ATTRIBUTE NODE_DOCUMENT NODE_TEXT	Not valid. Returns an error. These nodes cannot be children of a document node.
NODE_COMMENT NODE_PROCESSING_INSTRUCTION	Replaces the specified objoldChild with the supplied objnewChild and returns objoldChild.
NODE_ELEMENT	Replaces objoldChild with objnewChild and returns objoldChild. By definition, an XML document (the document node) can have only a single child element. Therefore, an error is returned if the document node already has a child element.

The following table lists possible child node types for the parent node type NODE_ELEMENT.

Child node type	Description
NODE_ATTRIBUTE NODE_DOCUMENT	Not valid. Returns an error. These node types cannot be children of an element node.
NODE_COMMENT NODE_ELEMENT NODE_PROCESSING_INSTRUCTION NODE_TEXT	Replaces the specified objoldChild with objnewChild and returns objoldChild.

Example

The following example creates a new IXMLDOMNodeIXMLDOMNode Object (Visual Basic .NET), newElem, and replaces the specified child node with newElem.

Imports interop_msxml
Imports Microsoft.WindowsMediaServices.Interop

On Error GoTo Err

' Declare variables.
Dim Server As New WMSServerClass()
Dim Playlist As IXMLDOMDocument
Dim root As IXMLDOMElement
Dim newElem As IXMLDOMElement

' Create a new playlist object.
Set Playlist = Server.CreatePlaylist

' Load a playlist.
Playlist.Load ("file://c:\wmpub\wmroot\simple.wsx")

' Retrieve the root element.
Set root = Playlist.documentElement

' Create a new element.
Set newElem = Playlist.createElement("seq")

' Replace the child of the current node with
' the newly created node.
root.childNodes.Item(1).replaceChild newElem, root.childNodes.Item(1).childNodes.Item(0)
Exit Sub

Err:
' TODO: Handle errors.

Requirements

Reference: Add references to Microsoft.WindowsMediaServices and interop_msxml.

Namespace: Microsoft.WindowsMediaServices.Interop, interop_msxml.

Assembly: Microsoft.WindowsMediaServices.dll, interop_msxml.dll.

Library: WMSServerTypeLib.dll, msxml.dll.

Platform: Windows Server 2003 family, Windows Server 2008 family.

See Also

Reference

IXMLDOMNode Object (Visual Basic .NET)

Concepts

XML DOM Methods (Visual Basic .NET)