XmlDocumentType::IsReadOnly Property

 

Gets a value indicating whether the node is read-only.

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

public:
property bool IsReadOnly {
	virtual bool get() override;
}

Property Value

Type: System::Boolean

true if the node is read-only; otherwise false.

Because DocumentType nodes are read-only, this property always returns true.

A read-only node is one whose properties, attributes, or children cannot be changed. However, you can remove a read-only node from the tree and insert it somewhere else.

You can remove a XmlDocumentType from a document and reinsert it back into the document as long as the document does not have an element node. Once a document has a root element, its XmlDocumentType cannot be changed.

This property is a Microsoft extension to the Document Object Model (DOM).

The following example displays information about the DocumentType node.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{

   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<!DOCTYPE book [<!ENTITY h 'hardcover'>]>"
   "<book genre='novel' ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "<style>&h;</style>"
   "</book>" );

   // Check if the node is read-only.
   if ( doc->DocumentType->IsReadOnly )
      Console::WriteLine( "Document type nodes are always read-only" );
}

.NET Framework
Available since 1.1
Return to top
Show: