XPathDocument Constructores

Definición

Inicializa una nueva instancia de la clase XPathDocument.

Sobrecargas

Nombre Description
XPathDocument(Stream)

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

XPathDocument(String)

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

XPathDocument(XmlReader)

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

XPathDocument(TextReader)

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

XPathDocument(String, XmlSpace)

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

XPathDocument(XmlReader, XmlSpace)

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

XPathDocument(Stream)

Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs

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

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

Objeto Stream que contiene los datos XML.

Excepciones

Se encontró un error en los datos XML. El XPathDocument permanece vacío.

El Stream objeto pasado como parámetro es null.

Se aplica a

XPathDocument(String)

Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs

Inicializa una nueva instancia de la XPathDocument clase 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 encontró un error en los datos XML. El XPathDocument permanece vacío.

El parámetro de ruta de acceso del 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)

Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs

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

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

Objeto XmlReader que contiene los datos XML.

Excepciones

Se encontró un error en los datos XML. El XPathDocument permanece vacío.

El XmlReader objeto pasado 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 un XPathDocument. Para cargar parte de un documento XML en , XPathDocumentcoloque el XmlReader objeto en el nodo XML superior desde el que cargar datos. Cuando se crea 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.

  • Un XmlReader objeto con la configuración de objeto asociada XmlResolver adecuada se puede usar 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)

Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs

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

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

Objeto TextReader que contiene los datos XML.

Excepciones

Se encontró un error en los datos XML. El XPathDocument permanece vacío.

El TextReader objeto pasado 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)

Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs

Inicializa una nueva instancia de la XPathDocument clase a partir de los datos XML del archivo especificado con el control de espacios 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 encontró un error en los datos XML. El XPathDocument permanece vacío.

El parámetro de ruta de acceso del archivo o XmlSpace el parámetro de objeto 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)

Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs
Source:
XPathDocument.cs

Inicializa una nueva instancia de la XPathDocument clase a partir de los datos XML contenidos en el objeto especificado XmlReader con el control de espacios 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

Objeto XmlReader que contiene los datos XML.

space
XmlSpace

Un objeto XmlSpace.

Excepciones

Se encontró un error en los datos XML. El XPathDocument permanece vacío.

El XmlReader parámetro de objeto o XmlSpace el parámetro de objeto 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