XmlDocumentType.IsReadOnly Właściwość

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Pobiera wartość wskazującą, czy węzeł jest tylko do odczytu.

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

public override bool IsReadOnly { get; }

member this.IsReadOnly : bool

Public Overrides ReadOnly Property IsReadOnly As Boolean

Wartość właściwości

Boolean

true jeśli węzeł jest tylko do odczytu; w przeciwnym razie , false.

Ponieważ węzły DocumentType są tylko do odczytu, ta właściwość zawsze zwraca wartość true.

Przykłady

Poniższy przykład przedstawia informacje o węźle DocumentType.

#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

Uwagi

Węzeł tylko do odczytu jest węzłem, którego nie można zmienić właściwości, atrybutów lub elementów podrzędnych. Można jednak usunąć węzeł tylko do odczytu z drzewa i wstawić go gdzie indziej.

Możesz usunąć element XmlDocumentType z dokumentu i ponownie go przywrócić do dokumentu, o ile dokument nie ma węzła elementu. Gdy dokument ma element główny, nie można go XmlDocumentType zmienić.

Ta właściwość jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).