XmlDocumentType.IsReadOnly-Eigenschaft

Ruft einen Wert ab, der angibt, ob der 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 XmlDocumentType
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 Knoten schreibgeschützt ist, andernfalls false. Da DocumentType-Knoten schreibgeschützt sind, gibt diese Eigenschaft immer true 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 jedoch aus der Struktur entfernen und an anderer Stelle einfügen.

Sie können einen XmlDocumentType aus einem Dokument entfernen und wieder in dieses einfügen, solange das Dokument über keinen Elementknoten verfügt. Sobald ein Dokument über ein Stammelement verfügt, kann der XmlDocumentType nicht mehr geändert werden.

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

Beispiel

Im folgenden Beispiel werden Informationen zum DocumentType-Knoten angezeigt.

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>")
        
        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 '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.DocumentType.IsReadOnly)
       Console.WriteLine("Document type 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->DocumentType->IsReadOnly )
      Console::WriteLine( "Document type 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_DocumentType().get_IsReadOnly()) {
            Console.WriteLine("Document type nodes are always read-only");
        }
    } //main 
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

XmlDocumentType-Klasse
XmlDocumentType-Member
System.Xml-Namespace