XmlDocumentType.IsReadOnly Eigenschaft

Definition

Namespace:

System.Xml

Assembly:

System.Xml.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

truewenn der Knoten schreibgeschützt ist; andernfalls . false

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

Beispiele

Im folgenden Beispiel werden Informationen zum DocumentType-Knoten angezeigt.

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 aus einem Dokument entfernen und es wieder in das Dokument einfügen, solange das Dokument nicht über einen Elementknoten verfügt. Sobald ein Dokument über ein Stammelement verfügt, kann es XmlDocumentType nicht mehr geändert werden.

Diese Eigenschaft ist eine Microsoft-Erweiterung für das Document Object Model (DOM).