XmlDataDocument::CreateElement Method (String^, String^, String^)

 

Creates an element with the specified Prefix, LocalName , and NamespaceURI.

Namespace:   System.Xml
Assembly:  System.Data (in System.Data.dll)

public:
virtual XmlElement^ CreateElement(
	String^ prefix,
	String^ localName,
	String^ namespaceURI
) override

Parameters

prefix
Type: System::String^

The prefix of the new element. If String.Empty or null, there is no prefix.

localName
Type: System::String^

The local name of the new element.

namespaceURI
Type: System::String^

The namespace Uniform Resource Identifier (URI) of the new element. If String.Empty or null, there is no namespaceURI.

Return Value

Type: System.Xml::XmlElement^

A new XmlElement.

Note to Inheritors If you overload this function, it cannot be used for extensibility. Instead, you can return an element created by the base class, in this case, XmlDataDocument. See the following example.

class MyXmlDataDocument : XmlDataDocument {
 public override XmlElement CreateElement(string prefix, string localName, string nsURI) {
   //Ensure we are returning the base class implementation of element.
   XmlElement e = base.CreateElement(prefix, localName, nsURI);
   //Add additional code here.
   return e;    //Return the element created by XmlDataDocument.
 }    
}

.NET Framework
Available since 1.1
Return to top
Show: