XPathDocument Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.XPathDocumentPublic Sub New (stream As Stream)Parámetros
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.XPathDocumentPublic 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.XPathDocumentPublic Sub New (reader As XmlReader)Parámetros
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.XPathDocumentnew System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocumentPublic 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.XPathDocumentPublic Sub New (uri As String, space As XmlSpace)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 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.XPathDocumentPublic Sub New (reader As XmlReader, space As XmlSpace)Parámetros
Excepciones
Se ha detectado un error en los datos XML. El objeto XPathDocument permanece vacío.
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.