XmlDocument.IsReadOnly-Eigenschaft

Ruft einen Wert ab, der angibt, ob der aktuelle Knoten schreibgeschützt ist.

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

Syntax

'Declaration
Public Overrides ReadOnly Property IsReadOnly As Boolean
'Usage
Dim instance As XmlDocument
Dim value As Boolean

value = instance.IsReadOnly

public override bool IsReadOnly { get; }

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

/** @property */
public boolean get_IsReadOnly ()

public override function get IsReadOnly () : boolean

Eigenschaftenwert

true, wenn der aktuelle Knoten schreibgeschützt ist, andernfalls false. XmlDocument-Knoten geben immer false zurück.

Hinweise

Bei einem schreibgeschützten Knoten können Eigenschaften, Attribute und untergeordnete Elemente nicht geändert werden. Sie können einen schreibgeschützten Knoten aus der Struktur entfernen und an anderer Stelle einfügen.

Diese Eigenschaft ist eine Microsoft-Erweiterung des Dokumentobjektmodells (Document Object Model, DOM).

Beispiel

Im folgenden Beispiel wird die Verwendung der IsReadOnly-Eigenschaft veranschaulicht.

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>")
        
        'Determine whether 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

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>");

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

  }
}

#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->DocumentElement->LastChild->FirstChild->IsReadOnly )
      Console::WriteLine( "Entity reference nodes are always read-only" );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        //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.get_DocumentElement().get_LastChild().
                get_FirstChild().get_IsReadOnly()) {
            Console.WriteLine("Entity reference nodes are always read-only");
        }
    } //main
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlDocument-Klasse
XmlDocument-Member
System.Xml-Namespace