XPathDocument Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da XPathDocument classe.
Sobrecargas
| Name | Description |
|---|---|
| XPathDocument(Stream) |
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML no objeto especificado Stream . |
| XPathDocument(String) |
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML no ficheiro especificado. |
| XPathDocument(XmlReader) |
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML contidos no objeto especificado XmlReader . |
| XPathDocument(TextReader) |
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML contidos no objeto especificado TextReader . |
| XPathDocument(String, XmlSpace) |
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML no ficheiro especificado com o tratamento de espaço em branco especificado. |
| XPathDocument(XmlReader, XmlSpace) |
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML contidos no objeto especificado XmlReader com a gestão de espaço em branco especificada. |
XPathDocument(Stream)
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML no 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.XPathDocumentPublic Sub New (stream As Stream)Parâmetros
Exceções
Foi encontrado um erro nos dados XML. Os XPathDocument restos estão vazios.
O Stream objeto passado como parâmetro é null.
Aplica-se a
XPathDocument(String)
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML no ficheiro 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
O caminho do ficheiro que contém os dados XML.
Exceções
Foi encontrado um erro nos dados XML. Os XPathDocument restos estão vazios.
O parâmetro do caminho do ficheiro é null.
Observações
Para preservar o espaço em branco, use o XPathDocument construtor que aceita um XmlSpace objeto como parâmetro.
Aplica-se a
XPathDocument(XmlReader)
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML contidos no 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.XPathDocumentPublic Sub New (reader As XmlReader)Parâmetros
Exceções
Foi encontrado um erro nos dados XML. Os XPathDocument restos estão vazios.
O XmlReader objeto passado como parâmetro é null.
Observações
Um XmlReader objeto pode ser usado para carregar um documento XML inteiro ou parte de um documento XML num XPathDocumentarquivo . Para carregar parte de um documento XML num XPathDocument, posicione o XmlReader objeto no nó XML superior para carregar os dados. Quando crias um XPathDocument usando o XPathDocument construtor, os dados são carregados do nó superior atual através de todos os seus irmãos. Depois, o XmlReader posiciona-se no escopo externo do nó XML superior. Alternativamente, pode usar o ReadSubtree método para carregar o XPathDocument num determinado elemento do documento XML.
Seguem-se as notas importantes a considerar quando usar o XPathDocument construtor.
Um XmlReader objeto com as definições de objeto associadas XmlResolver apropriadas pode ser usado para resolver entidades ou outras referências em dados XML.
Se o XmlReader objeto estiver posicionado num nó folha que não é válido para o nível raiz de um documento – por exemplo, um espaço em branco ou nó de atributo – o XmlReader objeto continua a ler até ser posicionado num nó que pode ser usado para a raiz. Começa XPathDocument a carregar neste ponto.
Para preservar o espaço em branco, use o XPathDocument construtor que aceita um XmlSpace objeto como parâmetro.
Aplica-se a
XPathDocument(TextReader)
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML contidos no objeto especificado TextReader .
public:
XPathDocument(System::IO::TextReader ^ reader);public:
XPathDocument(System::IO::TextReader ^ textReader);public XPathDocument(System.IO.TextReader reader);public XPathDocument(System.IO.TextReader textReader);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 (reader As TextReader)Public Sub New (textReader As TextReader)Parâmetros
- readertextReader
- TextReader
O TextReader objeto que contém os dados XML.
Exceções
Foi encontrado um erro nos dados XML. Os XPathDocument restos estão vazios.
O TextReader objeto passado como parâmetro é null.
Observações
Depois de o TextReader objeto ter sido usado para carregar dados XML, o cursor do TextReader objeto é posicionado no final dos dados. O TextReader objeto deve ser reiniciado para ler novamente os dados.
Aplica-se a
XPathDocument(String, XmlSpace)
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML no ficheiro especificado com o tratamento de espaço em branco 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
O caminho do ficheiro que contém os dados XML.
Exceções
Foi encontrado um erro nos dados XML. Os XPathDocument restos estão vazios.
O parâmetro do caminho do ficheiro ou XmlSpace do objeto é null.
Observações
O XmlSpace objeto passado como parâmetro especifica se deve preservar o espaço em branco. Default preserva apenas espaços em branco significativos; Preserve preserva todo o espaço em branco. Por defeito, o XmlSpace objeto está definido como Default.
A funcionalidade do XPathDocument construtor é idêntica à do XPathDocument construtor, exceto pelas opções de gestão de espaços em branco descritas.
Ver também
Aplica-se a
XPathDocument(XmlReader, XmlSpace)
Inicializa uma nova instância da XPathDocument classe a partir dos dados XML contidos no objeto especificado XmlReader com a gestão de espaço em branco especificada.
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
Exceções
Foi encontrado um erro nos dados XML. Os XPathDocument restos estão vazios.
Observações
O XmlSpace objeto passado como parâmetro especifica se deve preservar o espaço em branco. Default preserva apenas espaços em branco significativos; Preserve preserva todo o espaço em branco. Por defeito, o XmlSpace objeto está definido como Default.
A funcionalidade do XPathDocument construtor é idêntica à do XPathDocument construtor, exceto pelas opções de gestão de espaços em branco descritas.