XPathDocument Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe XPathDocument.
Sobrecargas
| Nome | Description |
|---|---|
| XPathDocument(Stream) |
Inicializa uma nova instância da classe dos XPathDocument dados XML no objeto especificado Stream . |
| XPathDocument(String) |
Inicializa uma nova instância da classe dos XPathDocument dados XML no arquivo especificado. |
| XPathDocument(XmlReader) |
Inicializa uma nova instância da classe dos XPathDocument dados XML contidos no objeto especificado XmlReader . |
| XPathDocument(TextReader) |
Inicializa uma nova instância da classe dos XPathDocument dados XML contidos no objeto especificado TextReader . |
| XPathDocument(String, XmlSpace) |
Inicializa uma nova instância da classe a XPathDocument partir dos dados XML no arquivo especificado com o tratamento de espaço em branco especificado. |
| XPathDocument(XmlReader, XmlSpace) |
Inicializa uma nova instância da classe dos XPathDocument dados XML contidos no objeto especificado XmlReader com o tratamento de espaço em branco especificado. |
XPathDocument(Stream)
Inicializa uma nova instância da classe dos XPathDocument 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
Um erro foi encontrado nos dados XML. Os XPathDocument restos estão vazios.
O Stream objeto passado como um parâmetro é null.
Aplica-se a
XPathDocument(String)
Inicializa uma nova instância da classe dos XPathDocument dados XML no arquivo 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 arquivo que contém os dados XML.
Exceções
Um erro foi encontrado nos dados XML. Os XPathDocument restos estão vazios.
O parâmetro de caminho do arquivo é null.
Comentários
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 classe dos XPathDocument 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
Um erro foi encontrado nos dados XML. Os XPathDocument restos estão vazios.
O XmlReader objeto passado como um parâmetro é null.
Comentários
Um XmlReader objeto pode ser usado para carregar um documento XML inteiro ou parte de um documento XML em um XPathDocument. Para carregar parte de um documento XML em um XPathDocument, posicione o XmlReader objeto no nó XML superior do qual carregar dados. Quando você cria um XPathDocument usando o construtor, os XPathDocument dados são carregados do nó superior atual por meio de todos os irmãos. Posteriormente, ele XmlReader é posicionado no escopo externo do nó XML superior. Como alternativa, você pode usar o ReadSubtree método para carregar em XPathDocument um elemento específico no documento XML.
Veja a seguir notas importantes a serem consideradas ao usar o XPathDocument construtor.
Um XmlReader objeto com as configuraçõ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 em um nó folha que não seja válido para o nível raiz de um documento - por exemplo, um nó de atributo ou espaço em branco - o XmlReader objeto continuará a ler até ser posicionado em um nó que pode ser usado para a raiz. O XPathDocument carregamento começa 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 classe dos XPathDocument 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
Um erro foi encontrado nos dados XML. Os XPathDocument restos estão vazios.
O TextReader objeto passado como um parâmetro é null.
Comentários
Depois que o TextReader objeto tiver sido usado para carregar dados XML, o cursor do TextReader objeto será posicionado no final dos dados. O TextReader objeto deve ser redefinido para ler os dados novamente.
Aplica-se a
XPathDocument(String, XmlSpace)
Inicializa uma nova instância da classe a XPathDocument partir dos dados XML no arquivo 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 arquivo que contém os dados XML.
Exceções
Um erro foi encontrado nos dados XML. Os XPathDocument restos estão vazios.
O parâmetro de caminho de arquivo ou XmlSpace parâmetro de objeto é null.
Comentários
O XmlSpace objeto passado como um parâmetro especifica se o espaço em branco deve ser preservado. Default preserva apenas espaço em branco significativo; Preserve preserva todo o espaço em branco. Por padrão, o XmlSpace objeto é definido como Default.
A funcionalidade do XPathDocument construtor é idêntica à do XPathDocument construtor, exceto pelas opções de tratamento de espaço em branco descritas.
Confira também
Aplica-se a
XPathDocument(XmlReader, XmlSpace)
Inicializa uma nova instância da classe dos XPathDocument dados XML contidos no objeto especificado XmlReader com o tratamento de espaço em branco 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
Exceções
Um erro foi encontrado nos dados XML. Os XPathDocument restos estão vazios.
Comentários
O XmlSpace objeto passado como um parâmetro especifica se o espaço em branco deve ser preservado. Default preserva apenas espaço em branco significativo; Preserve preserva todo o espaço em branco. Por padrão, o XmlSpace objeto é definido como Default.
A funcionalidade do XPathDocument construtor é idêntica à do XPathDocument construtor, exceto pelas opções de tratamento de espaço em branco descritas.