XmlDocumentType.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; falseandernfalls .

Da DocumentType-Knoten schreibgeschützt sind, gibt diese Eigenschaft immer true zurück.

Beispiele

Im folgenden Beispiel werden Informationen zum DocumentType-Knoten angezeigt.

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

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.DocumentType.IsReadOnly)
       Console.WriteLine("Document type 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>")
        
        Dim doctype As XmlDocumentType = doc.DocumentType
        
        ' Determine whether the node is read-only.
        If doctype.IsReadOnly Then
            Console.WriteLine("Document type 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.

Sie können ein XmlDocumentType Dokument entfernen und es wieder in das Dokument einfügen, solange das Dokument keinen Elementknoten besitzt. Sobald ein Dokument über ein Stammelement verfügt, kann es XmlDocumentType nicht geändert werden.

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