XmlEntityReference.BaseURI-Eigenschaft

Ruft den Basis-URI (Uniform Resource Identifier) des aktuellen Knotens ab.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overrides ReadOnly Property BaseURI As String
'Usage
Dim instance As XmlEntityReference
Dim value As String

value = instance.BaseURI

public override string BaseURI { get; }

public:
virtual property String^ BaseURI {
    String^ get () override;
}

/** @property */
public String get_BaseURI ()

public override function get BaseURI () : String

Eigenschaftenwert

Der Speicherort, von dem aus der Knoten geladen wurde.

Hinweise

Ein Netzwerk-XML-Dokument besteht aus Datensegmenten, die mithilfe verschiedener Standardeinschlussmechanismen des W3C zusammengesetzt werden, und enthält daher Knoten aus unterschiedlichen Quellen. Der BaseURI gibt die Quelle dieser Knoten an. Wenn kein Basis-URI für die zurückgegebenen Knoten vorhanden ist (wenn sie beispielsweise aus einer Zeichenfolge im Arbeitsspeicher ermittelt wurden), wird String.Empty zurückgegeben.

BaseURI durchläuft die Knotenstruktur und sucht dabei nach Grenzen von Entitätsverweisen. Beim Erweitern von Entitäten werden diese Informationen nicht beibehalten, und diese Eigenschaft gibt in allen Fällen die Position des XmlDocument zurück.

Weitere Informationen über BaseURI und das Verhalten gegenüber anderen Knotentypen erhalten Sie unter XmlNode.BaseURI.

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

Beispiel

Im folgenden Beispiel werden Informationen über den Entitätsverweisknoten einschließlich der Basis-URI veranschaulicht.

Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    'Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("https://localhost/uri.xml")
                     
    'Display information on the entity reference node.
    Dim entref as XmlEntityReference =  CType(doc.DocumentElement.LastChild.FirstChild, XmlEntityReference) 
    Console.WriteLine("Name of the entity reference:  {0}", entref.Name)
    Console.WriteLine("Base URI of the entity reference:  {0}", entref.BaseURI)
    Console.WriteLine("The entity replacement text:  {0}", entref.InnerText)
  end sub
end class

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.Load("https://localhost/uri.xml");
                     
    //Display information on the entity reference node.
    XmlEntityReference entref = (XmlEntityReference) doc.DocumentElement.LastChild.FirstChild;
    Console.WriteLine("Name of the entity reference:  {0}", entref.Name);
    Console.WriteLine("Base URI of the entity reference:  {0}", entref.BaseURI);
    Console.WriteLine("The entity replacement text:  {0}", entref.InnerText);
  }
}

#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->Load( "https://localhost/uri.xml" );
   
   //Display information on the entity reference node.
   XmlEntityReference^ entref = dynamic_cast<XmlEntityReference^>(doc->DocumentElement->LastChild->FirstChild);
   Console::WriteLine( "Name of the entity reference:  {0}", entref->Name );
   Console::WriteLine( "Base URI of the entity reference:  {0}", entref->BaseURI );
   Console::WriteLine( "The entity replacement text:  {0}", entref->InnerText );
}

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.Load("https://localhost/uri.xml");

        //Display information on the entity reference node.
        XmlEntityReference entRef = (XmlEntityReference)
            doc.get_DocumentElement().get_LastChild().get_FirstChild();
        Console.WriteLine("Name of the entity reference:  {0}", 
            entRef.get_Name());
        Console.WriteLine("Base URI of the entity reference:  {0}", 
            entRef.get_BaseURI());
        Console.WriteLine("The entity replacement text:  {0}", 
            entRef.get_InnerText());
    } //main
} //Sample

Im Beispiel wird die Datei uri.xml als Eingabe verwendet.

<!-- XML fragment -->
<!DOCTYPE book [<!ENTITY s SYSTEM "tmp/style.xml">]>
<book genre="novel">
  <title>Pride and Prejudice</title>
  <misc>&s;</misc>
</book>

Die style.xml-Datei enthält die XML-Zeichenfolge <style>hardcover</style>.

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