XmlEntityReference.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 XmlEntityReference
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 XmlEntityReference-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.

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

Beispiel

Im folgenden Beispiel wird die Verwendung der IsReadOnly-Eigenschaft veranschaulicht.

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>")
        
        ' 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 '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.
    XmlEntityReference entref = (XmlEntityReference) doc.DocumentElement.LastChild.FirstChild;
    if (entref.IsReadOnly)
       Console.WriteLine("Entity reference 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.
   XmlEntityReference^ entref = dynamic_cast<XmlEntityReference^>(doc->DocumentElement->LastChild->FirstChild);
   if ( entref->IsReadOnly )
      Console::WriteLine( "Entity reference 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.
        XmlEntityReference entRef = (XmlEntityReference)
            doc.get_DocumentElement().get_LastChild().get_FirstChild();
        if (entRef.get_IsReadOnly()) {
            Console.WriteLine("Entity reference nodes are always read-only");
        }
    } //main
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlEntityReference-Klasse
XmlEntityReference-Member
System.Xml-Namespace