Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

XmlDocument.IsReadOnly Property

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

[Visual Basic]
Overrides Public ReadOnly Property IsReadOnly As Boolean
[C#]
public override bool IsReadOnly {get;}
[C++]
public: __property bool get_IsReadOnly();
[JScript]
public override function get IsReadOnly() : Boolean;

Property Value

true if the current node is read-only; otherwise false. XmlDocument nodes always return false.

Remarks

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

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

Example

[Visual Basic, C#, C++] The following example shows how to use the IsReadOnly property.

[Visual Basic] 
Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New 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.DocumentElement.LastChild.FirstChild.IsReadOnly Then
            Console.WriteLine("Entity reference nodes are always read-only")
        End If 
    End Sub 'Main
End Class 'Sample

[C#] 
using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new 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.DocumentElement.LastChild.FirstChild.IsReadOnly)
       Console.WriteLine("Entity reference nodes are always read-only");

  }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

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

    //Check if the node is read-only.
    if (doc->DocumentElement->LastChild->FirstChild->IsReadOnly)
       Console::WriteLine(S"Entity reference nodes are always read-only");

}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

XmlDocument Class | XmlDocument Members | System.Xml Namespace

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft