XmlEntityReference.IsReadOnly Eigenschaft

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Ruft einen Wert ab, der angibt, ob der 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 Knoten schreibgeschützt ist, andernfalls false.

Da XmlEntityReference-Knoten schreibgeschützt sind, gibt diese Eigenschaft immer true 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.
   XmlEntityReference^ entref = dynamic_cast<XmlEntityReference^>(doc->DocumentElement->LastChild->FirstChild);
   if ( entref->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.
    XmlEntityReference entref = (XmlEntityReference) doc.DocumentElement.LastChild.FirstChild;
    if (entref.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.
        Dim entref As XmlEntityReference = CType(doc.DocumentElement.LastChild.FirstChild, XmlEntityReference)
        If entref.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 jedoch einen schreibgeschützten Knoten aus der Struktur entfernen und an einer anderen Stelle einfügen.

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