XmlEntityReference.BaseURI Propriedade

Definição

Espaço de Nomes:

System.Xml

Assemblagens:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlEntityReference.cs

Obtém o Identificador Uniforme de Recursos (URI) base do nó atual.

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

public override string BaseURI { get; }

member this.BaseURI : string

Public Overrides ReadOnly Property BaseURI As String

Valor de Propriedade

String

O local de onde o nó foi carregado.

Exemplos

O exemplo seguinte apresenta informação sobre o nó de referência da entidade, incluindo o seu URI base.

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

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.Load("http://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);
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    'Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("http://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

A amostra utiliza o ficheiro , uri.xmlcomo entrada.

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

O style.xml ficheiro contém a cadeia <style>hardcover</style>XML .

Observações

Um documento XML em rede é composto por blocos de dados agregados usando vários mecanismos de inclusão padrão do World Wide Web Consortium (W3C) e, por isso, contém nós provenientes de diferentes locais. Diz-te BaseURI de onde vieram esses nós. Se não houver URI base para os nós devolvidos (talvez tenham sido analisados a partir de uma cadeia em memória), Empty é devolvido.

BaseURI percorre a árvore de nós à procura de limites de referência de entidades, por isso, se as entidades forem expandidas, esta informação não é preservada e esta propriedade devolve a localização do XmlDocument em todos os casos.

Para informações adicionais sobre BaseURI e como se comporta com outros tipos de nós, veja XmlNode.BaseURI.

Esta propriedade é uma extensão da Microsoft para o Modelo de Objetos do Documento (DOM).