XmlDocument.IsReadOnly Eigenschaft

Definition

Namespace:

System.Xml

Assemblys:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

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

public override bool IsReadOnly { get; }

member this.IsReadOnly : bool

Public Overrides ReadOnly Property IsReadOnly As Boolean

Eigenschaftswert

Boolean

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

Beispiele

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

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

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

Option Explicit
Option Strict

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
End Class

Hinweise

Ein schreibgeschützter Knoten ist ein Knoten, dessen Eigenschaften, Attribute oder untergeordnete Elemente nicht geändert werden können. Sie können einen schreibgeschützten Knoten aus der Struktur entfernen und an einer anderen Stelle einfügen.

Diese Eigenschaft ist eine Microsoft-Erweiterung des Dokumentobjektmodells (DOM).