Comparteix a través de


XPathDocument Constructores

Definición

Inicializa una nueva instancia de la clase XPathDocument.

Sobrecargas

XPathDocument(Stream)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML del objeto Stream especificado.

XPathDocument(String)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML del archivo especificado.

XPathDocument(XmlReader)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML que contiene el objeto XmlReader especificado.

XPathDocument(TextReader)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML que contiene el objeto TextReader especificado.

XPathDocument(String, XmlSpace)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML del archivo especificado con el control de espacio en blanco especificado.

XPathDocument(XmlReader, XmlSpace)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML contenidos en el objeto XmlReader especificado con el control del espacio en blanco especificado.

XPathDocument(Stream)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML del objeto Stream especificado.

public:
 XPathDocument(System::IO::Stream ^ stream);
public XPathDocument (System.IO.Stream stream);
new System.Xml.XPath.XPathDocument : System.IO.Stream -> System.Xml.XPath.XPathDocument
Public Sub New (stream As Stream)

Parámetros

stream
Stream

El objeto Stream que contiene los datos XML.

Excepciones

Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.

El objeto Stream que se pasa como parámetro es null.

Se aplica a

XPathDocument(String)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML del archivo especificado.

public:
 XPathDocument(System::String ^ uri);
public XPathDocument (string uri);
new System.Xml.XPath.XPathDocument : string -> System.Xml.XPath.XPathDocument
Public Sub New (uri As String)

Parámetros

uri
String

Ruta de acceso del archivo que contiene los datos XML.

Excepciones

Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.

El parámetro de ruta de acceso al archivo es null.

Comentarios

Para conservar el espacio en blanco, use el XPathDocument constructor que acepta un XmlSpace objeto como parámetro.

Se aplica a

XPathDocument(XmlReader)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML que contiene el objeto XmlReader especificado.

public:
 XPathDocument(System::Xml::XmlReader ^ reader);
public XPathDocument (System.Xml.XmlReader reader);
new System.Xml.XPath.XPathDocument : System.Xml.XmlReader -> System.Xml.XPath.XPathDocument
Public Sub New (reader As XmlReader)

Parámetros

reader
XmlReader

El objeto XmlReader que contiene los datos XML.

Excepciones

Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.

El objeto XmlReader que se pasa como parámetro es null.

Comentarios

Un XmlReader objeto se puede usar para cargar un documento XML completo o parte de un documento XML en .XPathDocument Para cargar parte de un documento XML en , XPathDocumentcoloque el objeto en el nodo XML superior desde el XmlReader que cargar datos. Al crear un XPathDocument mediante el XPathDocument constructor , los datos se cargan desde el nodo superior actual a través de todos sus elementos del mismo nivel. Después, XmlReader se coloca en el ámbito exterior del nodo XML superior. Como alternativa, puede usar el ReadSubtree método para cargar en XPathDocument un elemento determinado del documento XML.

A continuación se muestran notas importantes que se deben tener en cuenta al usar el XPathDocument constructor .

  • Se puede usar un XmlReader objeto con la configuración de objeto asociada XmlResolver adecuada para resolver entidades u otras referencias en datos XML.

  • Si el XmlReader objeto se coloca en un nodo hoja que no es válido para el nivel raíz de un documento (por ejemplo, un espacio en blanco o un nodo de atributo), el XmlReader objeto continúa leyendo hasta que se coloca en un nodo que se puede usar para la raíz. XPathDocument comienza a cargarse en este momento.

  • Para conservar el espacio en blanco, use el XPathDocument constructor que acepta un XmlSpace objeto como parámetro.

Se aplica a

XPathDocument(TextReader)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML que contiene el objeto TextReader especificado.

public:
 XPathDocument(System::IO::TextReader ^ textReader);
public:
 XPathDocument(System::IO::TextReader ^ reader);
public XPathDocument (System.IO.TextReader textReader);
public XPathDocument (System.IO.TextReader reader);
new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument
new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument
Public Sub New (textReader As TextReader)
Public Sub New (reader As TextReader)

Parámetros

textReaderreader
TextReader

El objeto TextReader que contiene los datos XML.

Excepciones

Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.

El objeto TextReader que se pasa como parámetro es null.

Comentarios

Una vez utilizado el TextReader objeto para cargar datos XML, el cursor del TextReader objeto se coloca al final de los datos. El TextReader objeto debe restablecerse para volver a leer los datos.

Se aplica a

XPathDocument(String, XmlSpace)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML del archivo especificado con el control de espacio en blanco especificado.

public:
 XPathDocument(System::String ^ uri, System::Xml::XmlSpace space);
public XPathDocument (string uri, System.Xml.XmlSpace space);
new System.Xml.XPath.XPathDocument : string * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument
Public Sub New (uri As String, space As XmlSpace)

Parámetros

uri
String

Ruta de acceso del archivo que contiene los datos XML.

space
XmlSpace

Un objeto XmlSpace.

Excepciones

Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.

El parámetro de ruta de acceso del archivo o el parámetro de objeto XmlSpace es null.

Comentarios

  • El XmlSpace objeto pasado como parámetro especifica si se debe conservar el espacio en blanco. Default conserva solo espacios en blanco significativos; Preserve conserva todos los espacios en blanco. De forma predeterminada, el XmlSpace objeto se establece en Default.

  • La funcionalidad del XPathDocument constructor es idéntica a la XPathDocument del constructor, excepto las opciones de control de espacios en blanco descritas.

Consulte también

Se aplica a

XPathDocument(XmlReader, XmlSpace)

Inicializa una instancia nueva de la clase XPathDocument a partir de los datos XML contenidos en el objeto XmlReader especificado con el control del espacio en blanco especificado.

public:
 XPathDocument(System::Xml::XmlReader ^ reader, System::Xml::XmlSpace space);
public XPathDocument (System.Xml.XmlReader reader, System.Xml.XmlSpace space);
new System.Xml.XPath.XPathDocument : System.Xml.XmlReader * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument
Public Sub New (reader As XmlReader, space As XmlSpace)

Parámetros

reader
XmlReader

El objeto XmlReader que contiene los datos XML.

space
XmlSpace

Un objeto XmlSpace.

Excepciones

Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.

Los parámetros de objeto XmlReader o XmlSpace son null.

Comentarios

  • El XmlSpace objeto pasado como parámetro especifica si se debe conservar el espacio en blanco. Default conserva solo espacios en blanco significativos; Preserve conserva todos los espacios en blanco. De forma predeterminada, el XmlSpace objeto se establece en Default.

  • La funcionalidad del XPathDocument constructor es idéntica a la XPathDocument del constructor, excepto las opciones de control de espacios en blanco descritas.

Consulte también

Se aplica a